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Make sure you read the indicated pages for the stock number 
of the package that you are going to uSe.. 
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STOCK ADDENDUM PAGES TO READ 

NUMBER 

26-2013 MODEL I version pages l, 3, 4, 5, 6, and 7 
MODEL III version page 2 

26-2203 MODEL I version pages l, 3, 4, 5, and 6 
MODEL III version page 2 

26-2204 MODEL I version pages l, 3, 4, 5, and 6 
MODEL III version page 2 

26-2206 MODEL I pages l, 3, 4, 5, and 6 

26-2207 MODEL III page 2 

26-2208 MODEL I pages l, 3, 4, 5, and 6 

26-2209 MODEL III page 2 

26-1149 MODEL I version page 1, 3, 4, 5, 6, and 8 


MODEL III version page 2, 8 
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UPGRADE UTILITY ON TRSDOS 2. 3B 
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The MODEL I diskette in this package contains a NEW version 
of TRSDOS which is not compatible with OLD versions of 
TRSDOS, see below for further details. 


, ssnasendiprmaradiemawedibesnadliaasenadlnmediapencesd aacnditeinmadipamntienpeneall nmmsedl neat cemmadietementamandinstenatiaamsatinmmnadtindtibamadimp malian aaateemnmatitamtanntitetamrdadmsation mandi naattinemdlitinmaattaanmaditmmsadice mumtpeamalitnemmanditzsmadimmanatiemneatinanmmmatieamtinimn mation natittiemdlammattonssaditene atten dimandicemaatitnnaattemmadlteaaaamemantiamnatieumdtaenimdimmmatinensatitensadiitnamnd 
ND TS ED DD cD CREED we meee cme rm SE ce me SD re DD ED me ED EUR ED Ce cre SSD scm cee com SD ee ee ee Ore oe cee cee wee oe cee see -om nee SD re nm Dee Geet wD come 20 cm we ee 


OLD TRSDOS diskettes to be used under the NEW TRSDOS MUST be 
UPGRADEd before use. Once UPGRADEd, a system or data 
diskette becomes a NEW TRSDOS data diskette. 


OLD diskettes used under NEW TRSDOS without UPGRADEing, may 
cause extraneous information to be read at the end of files, 
giving a false End Of File (EOF) indication. Some programs 
will not function properly under these conditions. 


NEW diskettes usel under OLD TRSDOS, may not access all 
data and/or NEW programs may not run correctly. 


If you determine that you need to use the UPGRADE utility 
see page titled "TIPS ON USING THE MODEL I TRSDOS 2.3B 
UPGRADE UTILITY" contained in this addendum. 


NOTE: When changing from one TRSDOS to the other you must 
use the RESET switch each time the diskette in drive 0 
is changed. 


RADIO SHACK APPLICATION PROGRAMS WHICH WERE DELIVERED ON AN 
OLD TRSDOS DISKETTE SHOULD NOT BE UPGRADED. 


OLD: TRSDOS 2.1, 2.2, and 2.3. 

NEW: TRSDOS 2. 3B. 

file: A collection of information stored as one 
named unit in the directory. 

program: A file which causes the computer to 
perform a function. 

data: Information contained in a file which is 


used by a program. 

system diskette: A diskette containing TRSDOS. When this 
diskette is placed in drive 0 and the 
RESET switch is pressed, TRSDOS will begin 
to run. | 

data diskette: A diskette which does not contain TRSDOS. 
If this diskette is placed in drive O and 
the RESET switch is pressed, the screen 
will clear and "NO SYSTEM" will be 
displayed. 

UPGRADE: A program contained on the TRSDOS 2. 3B 
diskette. 
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XFERSYS UTILITY ON TRSDOS 1.3 


The MODEL III diskette in this package contains a NEW 
version of TRSDOS which is not compatible with OLD versions 
of TRSDOS, see below for further details. 
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OLD TRSDOS diskettes to be used under the NEW TRSDOS MUST be 
XFERSYSed before use. Once XFERSYSed, an OLD TRSDOS diskette 
becomes a NEW TRSDOS diskette and should not be used with 
OLD TRSDOS again. If you started with an OLD system or data 
disk, the XFERSYSed diskette will be a NEW system or data 
diskette respectively. 


OLD diskettes used under NEW TRSDOS without XFERSYSing, may 
cause extraneous information to be read at the end of files, 
giving a false End Of File (EOF) indication. Some programs 
will not function properly under these conditions. 


NEW diskettes used under OLD TRSDOS, may not access all 
data and/or NEW programs may not run correctly. 


If you need to use the XFERSYS utility see the TRSDOS 
section of your TRS-80 MODEL III Disk System Owner's Manual. 





NOTE: When changing from one TRSDOS to the other you MUST 
use the RESET switch each time the diskette in drive 0 
is changed. You may also XFERSYS onto a NEW data disk. 
If this is done, all system files of the system disk 
will be moved onto the data disk. 


RADIO SHACK APPLICATION PROGRAMS WHICH WERE DELIVERED ON AN 
OLD TRSDOS DISKETTE SHOULD NOT BE XFERSYSD. 


OLD: TRSDOS 1.1 and 1.2. 

NEW: TRSDOS 1.3. 

file: A collection of information stored as one 
named unit in the directory. 

program: A file which causes the computer to 
perform a function. 

data: Information contained in a file which is 


used by a program. 

system diskette: A diskette containing TRSDOS. When this 
diskette is placed in drive 0 and the 
RESET switch is pressed, TRSDOS will begin 
to run. 

data diskette: A diskette which does not contain TRSDOS. 
If this diskette is placed in drive 0 and 
the RESET switch is pressed, the screen 
will clear and "Not a SYSTEM Disk" will be 
displayed. 

XFERSYS: A program contained on the TRSDOS 1.3 
diskette. 
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TO: Owners of the Communications Package, Series I Editor 


Assembler, BASIC Compiler, BASIC Runtime, COBOL 
Compiler, and COBOL Runtime. 


FROM: Radio Shack Computer Merchandising 





DATE: August 18, 1981 


RE: TRSDOS 2.3B for the MODEL I 


———— eee ec ee me me em we ee em em ce ees we em em eee eee we eee ee em ee ee eee ee ee em ee ee ee ee 


Differences between TRSDOS 2.3B and TRSDOS 2.3 are: 


1. Variable length records have been corrected, in all 
aspects. 


2. In most cases, your computer will not "hang up" when you 
attempt use of a device which is not connected and 
powered up. 


3. The DEVICE command has been deleted. 
4. The following commands have been added: 


CLS 
This command clears the display and puts it in the 64- 
character mode. 


PATCH 'filespec' (ADD=aaaa, FIND=bb,CHG=cc ) 
This command lets you make a change to a program file. 
You need to specify: 





‘aaaa' - a four byte hexadecimal address specifying 
the memory location of the data you want to 
change 

‘bb' - the contents of the byte you want to find 


and change. You can specify the contents of 
more than one byte. 
‘cc' - the new contents to replace '‘'bb' 


For example: 

PATCH DUMMY/CMD (ADD=4567,FIND=CD3300,CHG=CD3B00 ) 
changes CD3300, which resides at memory location 4567 
(HEX) in the file named DUMMY/CMD, to CD3B00. 


If this command gives you a STRING NOT FOUND error 
message, this means that either 'bb' does not exist, or 
else 'bb' crosses a sector boundary. If ‘'bb' crosses a 
sector boundary, you must patch your file one byte at 

a time. For example: 


PATCH DUMMY/CMD (ADD=4568, FIND=33,CHG=3B) 
replaces the contents of the second byte in the above 
example. 7 
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TAPE (S=Source device,D=destination device) 
This command transfers 2-80 machine-language programs 
from one device to the other. You must specify the 
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‘source device' and 'destination device' using these 
abbreviations: 

T - Tape 

D - Disk 

R - RAM (Memory) 
The only valid entries of this command are: 

TAPE (S=T,D=D) TAPE (S=T,D=R) TAPE (S=D,D=T) 
For example 

TAPE (S=D,D=T) 
starts a disk-to-tape transfer. TRSDOS will prompt you 
for the diskette File specification and ask you to press 
<ENTER> when the cassette recorder is ready for 
recording. 


CAUTION: When doing a tape-to-RAM transfer, do not use a 
loading address below 6000 (Hex), since this would write 
over TRSDOS or the tape command. 


5. These commands have been slightly changed: 


BACKUP now checks to see if the diskette which will be 
your backup copy is already formatted. If it is, BACKUP 
will ask you if you want to REFORMAT it. 


CLOCK will no longer increment the date when the time 
goes beyond 23:59:59. 


COPY now works with only one-drive. For example: 

COPY FILE1:0 to FILE3:0 
duplicates the contents of FILE1 to a file named FILE3 
on the same diskette. 


KILL will now allow you to kill a protected file without 
knowing its UPDATE or protection level. To kill this 
kind of file, type an exclamation mark (!) at the end of 
the KILL command. For example: 

KILL EXAMPLE ! 
kills the UPDATEd or protected file named EXAMPLE. 
(Note the mandatory space between the file name and the 
exclamation mark.) 


LIST only lists the printable ASCII characters. 
PROT no longer allows you to use the UNLOCK parameter. 


DIR is now in this format: 


Disk Name: TRSDOS Drive: 0 04/15/81 

Filename Attrb LRL #Rec #Grn #ext EOF 
JOBFILE/BLD N*xX0 256 1 1 1 1 
TERMINAL/V1L N*xX0 256 5 2 1 126 
LOADX/CMD N*xX0 256 5 2 1 0 


**k* 171 Free Granules *** 
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1. Disk name is the name which was assigned to the disk 
when it was formatted. 

2. File Name is the name and extension which was 
assigned to the file when it was created. The password (if 
any) is not shown. 

3. Attributes is a four-character field: 
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a. the first character is either I (Invisible file) 
or N (Non-invisable file) | 
b. the second character is S (System file) or * 
(User file) 
c. the third character is the password protection 
status of the file: 
X - the file is unprotected (no password) 
A - the file has an access word but no 
update word 
U - the file has an update word but no 
access word 
B - the file has both update and access 
word | 
d. the fourth character specifies the level of 
access assigned to the access word: 
0 - total access 
1 - kill the file and everything listed 
below 
2 - rename the file and everything listed 
below 
- this designation is not used 
- write and everything listed below 
read and everything listed below 
- execute only 
- no access 


“IOV O1 ® W 
{ 


4. Number of Free Granules - how many free granules 
remain on the diskette. 

5. Logical Record Length - the record length which was 
assigned to the file when it was created. 

6. Number of Records - how many logical records have 
been written. | 

7. Number of Granules - how many granules have been used 
in that particular file. 

8. Number of Extents - how many segments (contiguous 
blocks of up to 32 granules) of disk space are allocated to 
the file. 

9, End of File (EOF) - shows the last byte number of the 
file. 
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TIPS ON USING THE MODEL I TRSDOS 2.3B UPGRADE UTILITY 
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If you determine that you need to use the UPGRADE 
utility then proceed as indicated below. 


Insert your TRSDOS 2.3B system diskette in drive 0, | 
press the RESET switch, and when TRSDOS READY is displayed 
type UPGRADE <ENTER>. Your screen will display: 


TRSDOS DIRECTORY UPGRADE UTILITY 


FOR CONVERSION OF TRSDOS 2.1, 2.2, OR 2.3 TO 
TRSDOS 2.3B DIRECTORY FORMAT. 


ONCE UPGRADE HAS BEEN EXECUTED, YOUR DISKETTE SHOULD 
NOT BE USED UNDER TRSDOS 2.1, 2.2, OR 2.3 AGAIN. 


DO YOU WISH TO CONTINUE (Y/N/Q)? 


This means that the directory format on your TRSDOS 
2.1, 2.2, or 2.3 diskette will be converted to the TRSDOS 
2.3B format. Once you type Y to continue, the screen will 
display: 


INSERT DISKETTE TO BE UPGRADED IN DRIVE Il. 
PRESS <ENTER> WHEN READY. 


Insert the diskette you want to convert in drive 1 and 
press <ENTER>. After successful conversion, the screen will 
display a CONVERSION COMPLETE message. If you are attempting 
to convert a diskette which has already been converted, the 
screen will display a DISKETTE IS ALREADY A 2.3B error 
message. 
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TECHNICAL NOTE 


For all files indicated in the directory that have an End Of 
FIle (EOF) not equal to zero, UPGRADE will change the number 
of records to be one less than the previous record count. 
Note that in FILE]1, the number of records indicated has been 
changed from 10 to 9 after UPGRADE. For FILE2 the records 
indicated remain the same since EOF=0. 


BEFORE UPGRADE AFTER UPGRADE 
TRSDOS 2.1, 2.2, 2.3 TRSDOS 2. 3B 
FILE1L EOF=9 10 RECORDS -9 RECORDS 
FILE2 EOF=0 10 RECORDS 10 RECORDS 


If the TRSDOS 2.1, 2.2, or 2.3 diskette is a system 
diskette, part of the conversion process will prohibit 
accidental usage under the TRSDOS 2.1, 2.2, or 2.3 by 
killing the files listed below: 


SYS0/SYS SYS1/SYS SYS2/SYS 
SYS3/SYS SsYs4/syYs  §yYS5/SYS 
SYS6/SYS FORMAT/CMD BACKUP/CMD 
BASICR/CMD BAS IC/CMD 
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The MODEL I diskette that contains your EDTASM package 
includes TRSDOS 2.3B which is not compatible with TRSDOS 
2.1, 2.2, or 2.3. Therefore, a machine language object file 
created with this package file CAN NOT simply be COPYied 
from TRSDOS 2.3B onto a TRSDOS 2.1, 2.2, or 2.3 diskette. 





See below for instructions on how to move an object file 
from TRSDOS 2.3B onto a TRSDOS 2.1, 2.2, or 2.3 diskette. 
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TIPS ON GETTING OBJECT FILES FROM TRSDOS 2. 3B 
ONTO TRSDOS 2.1, 2.2, OR 2.3 DISKETTES 


If for example, you desire to use an assembly language 
function written with TRSDOS 2.3B EDTASM as a "user's 
external subroutine" under the TRSDOS 2.3 BASIC interpreter, 
follow the given steps carefully: 


1) Insert your TRSDOS 2.3B system diskette that contains the 
EDTASM package in drive 0 and press the RESET switch. 


2) Use the EDTASM package to enter and assemble a routine. 
We have used the SHIFT routine given in Section 7 of your 
TRSDOS & DISK BASIC Reference Manual as an example. 


a) Save the source program using the command: 
W SHIFT/SRC:0 





b) Then assemble the source file with the command: 
A SHIFT/CMD:0 


c) Quit EDTASM with the command: 
Q 


d) At TRSDOS READY enter the command: 
LOAD SHIFT/CMD:0 


3) Remove your TRSDOS 2.3B diskette. 


4) Insert your TRSDOS 2.3 diskette in drive 0 and press the 
RESET switch. 


5) At TRSDOS READY enter the command: . 
DUMP SHIFT/CMD:0 (START=X'7D00', END=X'7D09', TRA=X'7D00' ) 


Reference Section 4 of your manual and note that X'7000' 
is the lowest address that may be used as the origin of 
your programs. 


6) The file on this diskette, named SHIFT/CMD, may now be 


used as needed under TRSDOS 2.1, 2.2, or 2.3 with the 
BASIC interpreter as a user's external subroutine. 
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The 26-1149 Communications Package is delivered on MODEL I 
TRSDOS 2.3B and Model III TRSDOS 1.3. Communication can 
occur MODEL I to I, III to III, or I to III, but only under 
MODEL I TRSDOS 2.3B and MODEL III TRSDOS 1.3. 


Data on MODEL I TRSDOS 2.1, 2.2, or 2.3 must be UPGRADEd to 
2.3B beofre it can be transmitted. Backup the diskette 
before UPGRADEING. 


Data on MODEL III TRSDOS 1.1 and 1.2 must be XFERSYSed to 
1.3 before it can be transmitted. Backup the diskette 
before XFERSYSing. 


NOTE: Radio Shack Application programs on TRSDOS 1.1, 1.2, 
2.1, 2.2, or 2.3 were tested on the particular 
version of TRSDOS they were purchased on. 


No quarantee is implied that these programs will 
work correctly after being UPDATEd to MODEL I TRSDOS 
2.3B or XFERSYSed to MODEL III TRSDOS 1.3. 


IMPORTANT NOTE FOR MODEL I USERS: You cannot run BASIC 
programs because TRSDOS 2.3 does not contain DISK BASIC, 


On page 20 of the Communications Package manual, we suggest 
you use SAVE, a DISK BASIC command, to save a transferred 
BASIC tape program on diskette. You will not be able to use 
the SAVE command with the TRSDOS 2.3B diskette, since it 
does not contain DISK BASIC. 
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Introduction 


What Is an Editor/Assembler? 


An editor/assembler is a two-part program that lets you communicate with a 
computer in its low-level, “‘native’’ language, rather than in some high level, 
‘‘foreign’’ language like BASIC or FORTRAN. We call this native language 
‘‘machine-language.’’ 


Using the editor, you enter the machine-language source code, consisting of a 
convenient set of abbreviations and symbols. The assembler then converts or 
assembles this into object code, which the Computer understands. 


But I thought my TRS-80 spoke BASIC! 


Well, you’re right, it does. But only because it contains a built-in BASIC 
interpreter. This interpreter converts or interprets your BASIC programs into 
object code, which the computer can understand. 


With a Built-In Interpreter, Who Needs Machine-Language? 
Well, if you— 

¢ Enjoy learning how things — especially, computers — work; 

¢ Want to do things faster than BASIC will allow; 


¢ Want to make the most efficient use of your Computer’s memory; 
¢ Want to modify the way your computer inputs and outputs data 


—then you need machine-language. (Of course, there are plenty of other 
reasons you may want to use it.) 


The Series-I Editor/Assembler 


There are two versions of this software package, one for tape and one for disk 
systems. 


Tape Version 


Three cassette tapes are included. One contains EDTASM, which is the Editor/ 
Assembler. Level II and Model III BAsic customers may load and run this tape 
using BASIC’s SYSTEM command. The second tape contains SYSTEM. This 
program is for Level I customers with a minimum of 16K memory. It is loaded 
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with the CLOAD command, and prepares the Level I Computer to load the 
EDTASM tape. The third tape contains a sample program for tape systems with at 
least 32K of RAM. If you have only 16K, you can still type in and use the sample 
program given in Section 5. 


Disk Version 


Two diskettes are included. There is one in Model I TRspDos format and one in 

Model III. 

The disk version software includes three programs: 

° EDTASM, the Editor/Assembler program 

° SAMPLE/SRC, a source listing of all the z-80 instructions 

* TPSRC, a utility to read source tapes written by the tape version of the Editor/ 
Assembler and two write object ““SYSTEM’’ tapes. 


The Series-I Editor/Assembler is especially good for beginners of machine 
language programming. Its commands and features are fairly simple, and it does 
not require that you understand advanced programming concepts. On the other 
hand, experienced programmers will find this editor/assembler a workable tool 
for all but the most complex, large-scale applications. 


Features 


Editor Features 


¢ Automatic line numbering for convenient source-code entry. 

¢ Line renumbering command with automatic renumbering if necessary. 
¢ Single-letter commands plus optional parameters. 

¢ Global search capability for changing your source text. 


¢ Source text may be saved on tape or disk, depending on your computer 
system. 


¢ Source files on tape or disk may be loaded or *‘chained’’ in memory. 
¢ Source text may be listed to the printer. 


Assembler Features 


¢ Controlled by a single-letter command with optional switches. 


¢ Options include: wait on error, no symbol table, list to printer, and trial 
assembly with no object code output. 


¢ Supports labels up to six characters long. 

¢ Eight pseudo-ops. 

¢ Resides in memory with the Editor, so you can easily go back and forth 
between editing and assembling. 
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INTRODUCTION 


Scope and Organization of This Book 


In this manual, we will show you how to use the Editor/Assembler. Along the 
way, we’ll cover a few principles of assembly-language programming. We’ll 
include a sample program. Even if you don’t understand assembly-language 
programming, you should be able to try out this sample program. 


In the next section (Section 2), we’ll tell you how to load the Editor/Assembler. 
We’ ll assume you already know how to start-up your Computer, and to get it to 
the BASIC READY level (cassette systems) or to the TRSDOS READY level (disk 
systems). There are separate loading instructions for: 


¢ Tape systems — Level I 
¢ Tape systems — Level II and Model III BAsiIc 
¢ Disk systems — Models I and III TRsDos 


In Section 3, we'll show you how to use the editor. This section is organized for 
ease of use the first time through. For quick reference later on, there’s an 
alphabetical summary of all editor features at the end of Section 3. 


In Section 4, we describe the assembler. Here we’ll simply explain the assembly 
command format and syntax. You’ll need this information when you get around 
to writing your own assembly-language programs. 


In Section 5, we present a sample assembly-language program. We go through 
all the procedures, from entering the program to loading and executing the 
assembled version. 


Section 6 is a complete Z-80 instruction set — the native language of your TRS-80. 


This manual is written for use with Model I or III systems using either tape or 
disk storage. There are a few operational differences, depending on which 
system you have. In these cases, we have written separate instructions for the 
differing systems. Follow those pertaining to your Computer. 


What else do I need? 


To write your own assembly-language programs, you'll need more information 
than is contained in this manual. If you know Z-80 or another assembly 
language, this manual will probably be sufficient. But if you’ve never done any 
assembly-language programming, you’ll need to do some further study. 


Radio Shack sells an ideal book for future TRS-80 assembly-language 
programmers: TRS-80 Assembly Language Programming, by William Barden, Jr. 
Its catalog number is 62-2006. Although it was written specifically for the 
Model I TRs-80, most of it applies as well to the Model II. 
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Notation and Special Terms Used in This Book 


Notations 

COMPUTER TYPE Indicates material that is input to or output from the 
Computer. Note: All computer prompts in this manual 
are given in uppercase. 

italic type Represents variable information that you provide in a 
command. (i.e., file names, line numbers, etc.) 

KEY Key which you should press. These will not be visible 
on the screen. 

[optional Square brackets enclose optional parts of a command. 

information] 


Special Terms 


source code (or text) An assembly-language source program you have loaded 
from tape or disk or typed. 


source file An assembly-language source program you have saved 
on tape or disk. 

object code The output from the assembler, i.e., coded z-80 
instructions. 

object file Object code stored on tape or disk so that it may be 


loaded and executed. 
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Part Two: 


Loading the Editor/Assembler 


Tape Systems— Level II and Model IIIT BASIC 


The Editor/Assembler is a machine-language program stored on tape at 500 
baud. Its file name is EDTASM. 


1. Turn on your Computer and press to the prompt for memory size. (In 
Model III systems, first type L to the CAss? prompt.) 


2. Get your recorder ready to play the Editor/Assembler tape. 


3. Type SYSTEM (ENTER), then EDTASM (ENTER). The Computer will begin loading 
from the tape. After a successful load (takes about 2 minutes), the *? prompt 
will reappear. 


4. Type / (ENTER). The Editor/Assembler starts by displaying a heading followed 
by an asterisk at the beginning of the next line. The asterisk is the prompt, 
telling you the Editor/Assembler is waiting for a command. 


Now skip to Section 3. 


Tape Systems— Level I BASIC 


Before you can load the Editor/Assembler tape, you must get your Computer 
into a “‘system’’ mode. The SYSTEM tape does this. 


1. Turn on your Computer. It should be in the READY mode. 
2. Get your recorder ready to play the SYSTEM tape. 


3. Type CLOAD (ENTER). The Computer will begin loading from the tape. After a 
successful load (takes about 2 minutes), a "PRESS ENTER WHEN CASSETTE 
IS READY" will appear on the next display line. Your Computer is now in 
the system mode. 


4. Prepare the recorder to play the EDTASM tape. 


5. Press (ENTER). The Computer will begin loading from the tape. After a 
successful load (takes about 2 minutes), the Editor/Assembler will start by 
displaying a heading followed by an asterisk at the beginning of the next line. 
The asterisk is the prompt, telling you the Editor/Assembler is waiting for a 
command. | 
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6. Volume setting may need to be adjusted for a successful load. 


Now skip to Section 3. 


Disk Systems 


The program file name for the Editor/Assembler is EDTASM/CMD. 
1. Under TRSDOS READY, type: EDTASM (ENTER). 


2. The Editor/Assembler will start by displaying a heading, followed by an 
asterisk on the next line. The * is the prompt, indicating the Editor/ 
Assembler is waiting for a command. 
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Part Three: 
Using the Editor 


Assuming you have just started the Editor/Assembler, it is displaying an asterisk 
on the screen. This is the “‘prompt.’ It tells you the Editor/Assembler is waiting 
for a command. 


The Editor consists of commands that allow you to create, edit, save and load 
your source programs. We’l! divide these commands into three groups: 
¢ Text-handling — creating and modifying the source program. 


¢ File input/output — saving the program on disk or tape and loading it from disk 
or tape. 


¢ Miscellaneous — getting the memory status, exiting from the Editor/ 
Assembler. 


Special Terms 


Before using the commands, we need to define a few special terms used in this 
section. 


‘‘text’’ is the information (source program) that you have entered into the 
Computer. The insert command allows you to begin entering text one line at a 
time, pressing (ENTER) at the end of each line. The Editor automatically numbers 
each line. 


‘‘text buffer’’ is the area in memory where your text is stored. 


‘‘current line’’ is the line most recently entered, displayed, or referenced in a 
command. 


‘*file’’ is the source text stored on tape or disk. 


‘‘file name’’ is the name given to the file. In tape systems, the file name consists 
of from one to six letters or numbers. In disk systems, the file name follows the 
rules of TRSDOs file specifications (for full details, see your TRSDOs reference 
manual): 


filename [/ext] [. password] [:d] 


‘‘inc’’ or “‘increment’’ refers to the number which is used to compute 
successive line numbers for your text. When you start the Editor, the increment 
equals 10. 
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‘‘line ref’’ or ‘line reference’’ is the way you specify a single line in your text. 
A line reference may be any number from 0 to 65529, or any of the following 
special symbols: 


Fs First line in the text buffer 
: The current line 
% The last line in the text buffer 


‘‘line range’’ indicates a range of lines in your text file; it is a pair of line 
references separated by a colon. 


line-ref:line-ref 


‘‘TOF’’ and ‘‘EOF’’ —refer to top of file (first line) and end of file (end of file). 
The Editor will use these abbreviations in certain messages to you. 


Sample Commands 


These examples are simply to show the use of the special terms and notation. 
The commands are explained later in detail. 


P 100 **Print line 100,’ 
P #:, **Print text from the first line to the current line. 
D, **Delete the current line’’ 


I line ref.,inc ‘°‘Start inserting at line, using inc as an increment between 
lines. (‘‘line ref.’’ and “‘inc’’ are variables you replace with 
appropriate values.) 

A Few Words about Spaces 


In general, spaces are not significant inside editor commands. You may use 
them or omit them. Exception: No spaces inside a file name, line reference or in 
the command (F)-Find. 


Special Keys 


ENTER To complete a command or a line of text, you must press this 
key. 

BREAK To cancel a command or to stop inserting text, press this key. 
The line that the (BREAK) is pressed is not saved. Press (BREAK 
on the line following the last line. 

(=) Press this key to see the previous line of text. 

(~w) Press this key to see the next line of text. 

(4) This key erases the previously typed character. 

(>) This functions as a tab key. You will use it while inserting 


text. The tab positions are spaced eight columns apart. 
LEFT (SHIFT) (@) This erases the line you have been typing. 


@ This causes a pause in a listing or printout. Press any key to 
continue. 


Editor Commands 


We’ ll cover the commands in a typical sequence in which you might use them. 
For an alphabetical summary, see the end of this section. 
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Text Handling Commands 


Inserting Your Text 


When the asterisk is displayed, you may type in a command — not your source 
text. To enter source text, you must get into the insertion mode. 


First, to get your Computer ‘‘in step’’ with our examples, type D #:* (ENTER). 
That erases any text that you might already have entered into the text buffer. 


Now we'll go into the insertion mode. Type I (ENTER). The Computer will 
display 00100. All we do is type in text for line 100 and press (ENTER). The 
Computer will automatically provide the next line number. 


02100 3s ANY CHARACTERS FOLLOWING A SEMI-COLON (3) IS A 
COMMENT (ENTER 
00112 


We may continue like this until we finish entering the text. Remember to press 
ENTER) at the end of each line. 


Q@@11@ $s PRESS -> AT THE START OF THE NEXT LINE (ENTER 
00120 RET 5A VERY SHORT PROGRAM (ENTER 
00130 


In line 120, we pressed tab ()) once at the beginning of the line, and once after 
RET. Tabs are very important in source programs; they are used instead of spaces 
to separate the standard fields in an assembly-language program. (We’ll explain 
further in part 4.) 


That’s all the text we want to type in for now, so press (BREAK). The asterisk will 
reappear on the next line. 


Displaying Your Text 


To see the text, use the Print command. For example: P #:* (ENTER). This tells 
the Computer to display all the lines in the text buffer. To see a single line, 
specify that line, as in: P 00 (ENTER). Another way to display lines one at a time 
is with (@) (previous line) and @) (next line). 


If you omit a line reference, the Computer will display a screenful of lines, 
Starting at the current line. This is a good way to look at a large text file, one 
screenful at a time. Simply press P (ENTER) to see the next screenful. 


Note: If the total file is to be displayed you may execute T (ENTER) prior to Print 
command to insure that current line is TOF. 


Getting a Hard-Copy of the Source Program 


To output to a line printer instead of to the display, substitute ‘‘H’’ (hard copy) 
for ‘‘p’’. For example, the command H #:* prints out the entire source program. 
If printer is not ready press (BREAK) to return to command line. 


(For instructions on getting hard copy of an assembled program, see Section 4.) 
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Adding Lines between Existing Lines 


Suppose you want to add a line between lines 100 and 110. Use the Insert 
command, but specify a starting line number between 100 and 110: 


I 185 


Q0105 sTHIS LINE IS ADDED (ENTER 
00115 (BREAK 


¥ 


When you pressed (ENTER) for line 105, the Computer used the current increment 
(10) to generate line 115, which will not be between 100 and 110. To insert more 
than one line between any two lines, you can specify an increment of 1. 


For example, 


I 105,+1 (ENTER 
00106 


Line 105 is already in use, so the Computer gives you the next number, using an 
increment of |: 


Q2106 sWE’LL JUST TYPE IN A FEW LINES 

Q@21@7 sNOTICE THAT THE INCREMENT OF 1 IS STILL IN USE (ENTER 
@@108 sWHAT WILL HAPPEN WHEN WE REACH LINE 110? (CENTER 

@@21@9 sTHAT LINE IS ALREADY IN USE . « » CENTER 

Q@11@ §. . . BUT EDTASM GIVES YOU THAT NUMBER ANYWAY. (CENTER 
@@iii (BREAK 


A line ‘‘collision’’ was about to occur when you entered line 110, since that 
number was already in use. So the Editor automatically renumbered all lines. 


To begin inserting lines at the end of the file, use the Bottom command, 
B (ENTER). This makes the current line the last line. 


Changing a Line in Your Text 


To make a change within a line of text, use the Edit command. This puts you in 
a special intra-line edit mode in which several useful functions are available. To 
begin editing a line, type E followed by the line number (or line symbol “*#’’, 
‘ss? ** ?) and press (ENTER). The Computer will display the line number 
followed by the cursor (blinking block or underline). This is your “‘working 
copy’’ of the line. Changes you make will not take effect until you exit from the 
intra-line edit mode. 


To exit from the intra-line edit mode, press (ENTER) or E (ENTER) and changes are 
saved. Press (BREAK) or 9 (ENTER) and the line remains in its original form. 
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Here are the functions available in the intra-line edit mode: 


Lists the line in its current form and starts a new working 
copy on the next line. 


n (SPACEBAR (Spacebar) Moves the cursor forward n spaces, showing the 
next n characters in the line. If n is omitted, 1 is used. 


(4) Moves cursor back one space in the line, but does not erase 
the character from the working copy. 


n@S)c (Search) Positions the cursor at the nth occurrence of 
character c, counting from the current cursor position. If n 
is omitted, positions to the first occurrence after the current 


position. 

n (D) Deletes the next n characters. If n is omitted, 1 1s used. 

n{)c (Kill) Deletes all characters up to the nth occurrence of 
character c. If n is omitted, deletes up to the first 
occurrence. 

nC@)cl...cn Changes the next n characters to characters c] . . . cn. 

(A) (Again) Cancels all changes made and lets you edit the line 
again. 

(I) newtext Insert newtext. Insertion will continue until you press 


(@) or (ENTER). While inserting, the (@) key will erase 
a character, and the will insert a space. You must 
exit from this insertion function before you can use any of 
the other editing functions. 


(X) (Extend) Begin inserting at the end of the line. 

® (Hack) Delete remainder of the line and begin inserting at 
the current position. 

or () Exits to the * command level. The changes you made will 
take effect. 

or @) (Quit) Exits to the * command level. The changes you made 


will be canceled. 


The best way to learn to use these edit functions is to experiment with them. For 
example, type E to start editing the current line. The Computer will 
display the line number. Press (L) to see the line in its current form and start a 
new working copy. Now try each of the commands listed above. 


Remember: To exit from the intra-line editor at any time, press (ENTER). To stop 
the insertion function but continue editing, press GHIFT) (=). 
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Replacing a Line 


You cannot use the Insert command to replace a line, because the Computer will 
always renumber the lines in case of a line collision. To replace a line, type R 
followed by the line reference and press (ENTER). 


For example, to replace line 100, type: R 100 (ENTER). The Computer will 
display 00100. Go ahead and type in the new text for this line. When you press 
(ENTER), the Computer will act just as it does in the line insertion mode: it will 
compute a new line number using the current increment and renumbering the 
lines if necessary to avoid a collision. From this point on, you are inserting, not 
replacing. Only line 100 is replaced. 


Deleting Lines 


To delete a range of lines, type D line range. For example, 


D 100 Deletes line 100 

D , Deletes the current line 

D 100:120 Deletes all lines from 100-120 
D #:% Deletes all lines (first to last) 


Finding a String within Your Text 


The Find command searches through your text for any one word string you 
specify, and tells you which lines contain the text. 


Suppose you have a large text file in memory, and you want to change each 
occurrence of ‘‘LBL’’ to ““LABEL.’ The Find command will identify each line 
that contains ‘‘LBL,’ Simply type: T to position the current line to the 
beginning of the text, then type FLBL (ENTER). The Computer will search for the 
string of characters immediately following the F and ending with the carriage 
return ((ENTER)). 


The editor will print the line number of the first occurrence of LBL. That line 
becomes the current line. You may begin editing it by typing E (ENTER). 


To find subsequent occurrences of LBL, simply type F (ENTER). The editor 
continues searching at the current position and remembers the string being 
searched. | 


Remember: (1) Type in the search string immediately after the *‘F’’ with no 
spaces, unless the search string starts with spaces. (2) The Find command 
begins searching at the current line, so set the current line to TOF first if you 
want to search through the entire text. 


Renumbering Your Text 


After inserting lines (and having them automatically renumbered), you may 
want to renumber them ‘‘manually.’’ The Number command does this. Type N 
start-line, increment (ENTER). Start-line will be the lowest-numbered line in the 
renumbered program. 
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For example, the command: N 1000;10 renumbers the text 1000, 
1010, 1020, etc. 


After renumbering, the current line is the last line in the file, and the increment 
is what you specified in the N command. 


If no start line is typed, the renumbering will begin with the current line. If no 
increment is specified, 10 is used. 
Source File Input/Output Commands 


In this section, we’ll show how to save a source program and then reload it. 
(For instructions on outputting and loading an object file, see Section 4.) 


There are three general groups of editor /o commands: 


¢ Writing the source program to tape or disk 
¢ Loading the source program from tape or disk 
¢ Printing the source program on the display or on a line printer. We’ve already 


described these commands (H and P). 
Saving the Source Program 


Once you have typed in and edited a source program, you should save it on tape 
or disk. That way, if you ever need to modify the source program, you won’t 
have to retype it; you can simply load it and make changes. 


The tape version of Editor/Assembler always assumes you want tape 1/O, and the 
disk version assumes you want disk 1o. (Disk systems may load source tapes 
via the TAPESRC utility, described later in the appendix. ) 


Note to Model III Customers: All tape Vo is done at 500 baud, regardless of the 
cassette baud rate you selected when you started up the Computer. 


Tape Systems 
1. Using a blank cassette tape, put your recorder into the record mode. 


2. Type W file (ENTER). Use a file name from one to six characters. You may omit 
the file name, in which case the tape file will be named NONAME. 


Example: 
W MOVE (ENTER 


3. The Editor/Assembler will prompt you to get the cassette recorder ready. Be 
sure it’s in the record mode, then press (ENTER). The Editor/Assembler will 
write the text onto the tape. 


4. After writing the tape, the Editor/Assembler will return to the command 
mode (asterisk). 


5. Make at least one additional tape copy of the program. 
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6. Remove the tape from the recorder and label it. Be sure to identify it as a 
source tape. | 


Disk Systems 


1. Type W file (ENTER). For file, use a standard TRspos file name with an optional 
password and drive specification. The Editor will automatically add the 
extension /SRC to the file name. To override this, include a different extension 
in the file specification. 


You may omit the file name, in which case the file will be called NONAME/ 
SRC. 


Example: 
W MOVE 
writes the source program into the file MOVE/SRC. 
2. After writing out the file, the Editor will return to the command mode 
(asterisk). 
Loading a Source Program 
Tape Systems 
1. Prepare the recorder to play the source tape. 


2. Type L file (ENTER). For file, substitute the correct file name. If there are 
several files on the tape, the Editor will search through them until it reaches 
the one you named. You may omit the file name, in which case the first file 
on the tape will be loaded. 


Before the Editor starts loading from the tape, it will prompt you to get the 
cassette recorder ready. Press when ready. 


3. After loading the source program, the Editor will return to the command 
mode (asterisk). 


Disk Systems 


1. Type L file (ENTER). For file, specify the file in standard TRspDos form. If the 
specification you give does not include an extension, the Editor will 
automatically use the extension /SRC. 


You may omit the file specification. The Editor will then attempt to load a file 
named NONAME/SRC. 
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(If you already have a source program in the text buffer, the Editor will 
warn you: 
TEXT IN BUFFER. CHAIN FILES? 


If you want to add the disk file onto the end of the current text in memory, 
type Y (ENTER). This will chain the new file onto the end of the file in memory 
and automatically renumbers the total file. If you don’t want to “‘chain’’ the 
files, but wish to erase the current file and load the new one, type N (ENTER). ) 


2. After loading the file, the Editor will return to the command mode (asterisk). 


Miscellaneous Commands 


Determining the Memory Status 


To find out the size of the current source program and the amount of free 
memory, type M (ENTER). The status will be shown in bytes. 


Exiting from the Editor/Assembler 


The quit command ( (ENTER)) takes you out of the Editor/Assembler and back 
to TRSDOS or BASIC (if you are in a level II computer). Before using this 
command, be sure to save your source program, if desired, because you won’t 
be able to recover it simply by restarting the Editor/Assembler. 


15 











SERIES | EDITOR/ASSEMBLER 


Editor Error and Warning Messages 


BAD PARAMETER(S) This indicates that you gave the 
editor an invalid command. 
Check the syntax used, and the 
values of parameters given (they 
may be out of range). 


BUFFER FULL The area assigned to text 
storage is full. You may be able 
to split the source text into two 
modules. 


LINE NUMBER TOO LARGE | During the generation of new line 
numbers (insertion or line 
renumbering) a line number 
greater than 65529 was needed. 
This is too large. Use a smaller 
line number increment. 


NO SUCH LINE A reference was made to an 
unused line number. 


NO TEXT IN BUFFER All commands except load, 
insert, memory-status, and quit 
require some text to be in the 
buffer. 


STRING NOT FOUND You issued a find command and 
the editor could not locate the 
string you specified. Be sure you 
had the current line set properly 
(find begins searching at the 
current line number). 
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Editor/Assembler Alphabetical Summary 


Special Keys 









ENTER 


©) 


HIF 


a & B UUSE 


Symbols and Abbreviations 


line ref 
line range 


inc 






Executes the current command. 
Cancels or interrupts a command. 


Erases the last character typed. 






Displays the previous text line. 






Displays the next text line. 






Erases the entire line. (Use left 
shift key only) 






Tabs forward eight spaces. 






Pauses execution of a command: 
press again to continue. 






Escapes from the character 
insertion command in the edit 
mode. (Use left shift key only) 







First line in text 
Last line in text 
Current line in text 


A single line number or line symbol 
(#, *, or.). 


A pair of line refs separated by a 
colon (line ref : line ref) 


An increment between lines. 
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Commands 









A [file] [,switch.. .] Assemble. Switches are: LP (line 
printer, WE (wait on error), NL (nO 
listing), NS (no symbol table), No 


(no object code output). 













B List bottom (last) line of text. 














D {line ref or line range] | Delete line(s). 

























E [line ref| Edit line ref. 
Subcommands 
Lists working copy of line 
n Advance n spaces. 
(4) Backspace 1 space. 
n@S)c Search for nth occurrence of c. 
nO) Delete next n characters. 
nc Kill up to nth occurrence of c. 


n€@)c1...cn Change next n characters to 


c7...cCn. 

















(A) Cancel changes and start again. 
(T) newtext Insert newtext. Press (ENTER) or 






(@) to quit. 

Extend line. 

Hack rest of line and begin 
inserting. 

Exits to the command level; 
changes take effect. 

Cancels changes and quits editing. 






(X) 
) 












ENTER) or (E) 














BREAK) or @Q) 


F [text string] Find the text string immediately 
following the letter ‘‘F’’; or find the 
current text string. (No space 


between (F) and text string). 















List lines on the printer. If printer 
not ready use to recover. 


[line range] 








Insert at /ine ref using inc. If no 
line ref has been determined 100 
is used. 


[line ref] [,inc] 











[file] Load a source file. 






Display memory status. 






[line ref] [,inc] Renumber text. 





[line range] List lines on the display. 
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Quit Editor/Assembler; return to 
TRSDOS Or BASIC (Level Il). 


R [line ref] Replace line and continue in the 
line insertion mode. 


T List top (first) line of text. 


W [file] Write a source file. 
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Part Four: 


Using the Assembler 


In Section 3, we showed you how to type in, edit, and save a source program. 
For a source program, we used an arbitrarily chosen text. 


Now we are ready to discuss the assembler — the software that converts your 
source text into object code that can be understood by the TRS-80’s Z-80 
microprocessor, and writes this object code to a tape or disk file. We’ll break 
this section up into three parts: 


A. The Assemble command — syntax, options, file output, error conditions, etc. 


B. Assembler language — definitions, syntax, input/output format, etc. 


If you’re new to assembly language, you don’t have to read all this now. You 
may skip to Section 5, which presents a sample programming session. This will 
give you hands-on experience with the Editor/Assembler. Then, when you come 
back to this section, you’ll have a better idea of what it’s all about. . . 


The Assemble Command 


You enter the Assemble command at the command level (asterisk). It consists 
of the abbreviation ‘‘A’’ followed by a space and an optional file name and 
optional switches. (We call them “‘switches’’ because they turn various 
functions on and off.) 


There are various combinations of spaces and commas that will work in the 
assemble command. For simplicity, we’ll stick with one workable set of rules 
for command syntax. 


A [file] [,switch.. .] 


The file name and switch are optional. (If no file name is used, you must still 
type in a space after the “*a’’) Every switch used must be preceded by a 
comma. Spaces before or after the file are acceptable and have no effect. 


A source program must be originated in RAM or loaded into RAM before it can be 
assembled. 
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For example: 
A ZAPsNS>»NL»WE (ENTER 


‘*ZAP’’ is the file name; ““NS’’, ‘‘NL’’ and ““WE’’ are switches. The commas are 
required. The meaning of this and the following commands will be explained in 
the following pages. 


A sNO WE »NS 
No file name is given. 
As another example: 

A 


No file name or switches are specified. 


File Name 


The file name you specify will be assigned to the tape or disk object file. If you 
omit a file name, ‘‘NONAME’’ will be used. (For further details, see File Output 
later in this section.) 


Switches 


If you don’t specify any switches in your assemble command, the Assembler 

will do the following: 

¢ Print the assembly listing on the screen 

¢ Print error and warning messages in the listing without pausing 

¢ Print a symbol table after the listing is completed 

¢ Output the object code to tape or disk, using the file name you specified (or 
‘‘NONAME’’ if you omitted one) 


Here are the switches available. You may use as many as you want in any order. 
Remember to put a comma before each switch used. 














(Line printer) Output listing, error messages, and 
symbol table to the line printer, not to the display. 


(Wait on error) Pause after each error message; 
operator presses (ENTER) to continue. 


(No listing) Don’t output an assembly listing. 
(No symbol table) Don’t output a symbol table. 


(No output) Don’t output any object code. 
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File Output — Disk Systems 


If you do not specify the No switch, and if no terminal errors occur during the 
assembly, the Assembler will write the object code to the disk file you specify. 


Use a standard TRspos file name with an optional password and drive 
specification. The Assembler will automatically add the extension ‘‘/CMD’’ to 
the file name. To override this, include a different extension in the file 
specification. 


If you omit a file specification, the Assembler will use *‘NONAME/CMD”’ as the 
object file. 


Examples: 

A ZAP +NO WE 

Waits on errors, does not output object code. 

A ZAP +LP 

Outputs the assembly listing to the printer, outputs object code to ZAP/CMD. 
Use of Object Files 


Every object file is stored in a special format that allows it to be loaded and 
executed by TRspos. An object file cannot be loaded by the Editor/Assembler. 
(Since it is no longer in text form, the Editor/Assembler can’t do anything 
with it.) 


To load and execute an object file program while you are in the TRSDOS READY 
mode, type the file name and press (ENTER). If the extension is *‘/CMD,”’ you 
don’t need to include it in the file name. 


To load an object file and return to TRSDOS READY, type LOAD filename (ENTER). 
In this case, you must include the extension even if it is ‘‘/CMD.’ For further 
details on the use of object files, see Section 5. 


Now skip ahead to ‘‘Assembler Error Messages.’ 


File Output — Tape Systems 
Note to Model III Customers: All tape output is done at 500 baud. 


If you do not specify the *‘NO’’ switch, and if no terminal errors occur, the 
Assembler will write the object code to cassette tape, using the file name you 
specify. The file name may be from one to six characters long. If you omit one, 
‘*NONAME’’ will be used. 


Before writing the tape, the Assembler will prompt you to get the cassette ready. 
Using a blank tape, prepare the recorder to record; when ready, press (ENTER). 
The Assembler will then write the tape. 


Make at least two copies of each object file. Remove the cassette and label it as 
an ‘“‘object’’ tape. 
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Use of Object Tapes 


Object tapes are stored in a special format for loading via the SYSTEM command. 
(Level I systems must first load the SYSTEM tape; then the object tape.) An 
object file cannot be loaded by the Editor/Assembler. (Since it is no longer in 
text form, the Editor/Assembler can’t do anything with it.) 


To load an object tape while in BASIC, type: SYSTEM then filename 
. After the tape has been loaded, you may press to return to 

BASIC, or / address to begin execution at the specified address. If you 
type / (ENTER), omitting the address, an address specified on the tape itself will 
be used. (For details, see the Section 5.) 


Assembler Error Messages — 
Four kinds of errors may occur after you enter an assemble command. 


1. Command errors. If there is an error in your command, no assembly will be 
attempted. The Assembler will display the message ““BAD PARAMETER(S)’ 


2. Terminal errors. During assembly, an unrecoverable error occurred. The 
assembly is cancelled. 


The only terminal error is *“SYMBOL TABLE OVERFLOW.’’ This occurs when 
there is not enough memory to handle the symbol tables required for 
assembly. Use a machine with more memory (if possible), or break the 
program up into modules and assemble them separately. 


3. Fatal errors. One of the source lines contained an error. No object code is 
generated for the offending line, but the assembly continues. Here are the 
terminal errors: 


BAD LABEL Invalid sequence of 
characters were used 
as a label. (See 
“labels.’) 


XPRESSION ERROR An invalid expression 
was used as an 
operand. (See 
“expressions. ) 


ILLEGAL ADDRESSING MODE One of the operands 
used is illegal with the 
specified Z-80 


instruction. 


ILLEGAL OPCODE Unrecognizable 
characters were used 
in the opcode 
(mnemonic) field. 


MISSING INFORMATION Mnemonic or 
operands are missing. 
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4. Warnings. A probable error occurred, but the assembler will generate object 
for the offending line anyway. The code may not be what the programmer 


intended. Warning messages are: 


BRANCH OUT OF RANGE 


FIELD OVERFLOW 


MULTIPALLY DEFINED SYMBOL 


MULTIPLE DEFINITION 
NO END STATEMENT 


UNDEFINED SYMBOL 


Assembly Language 





Relative branch 
instruction outside of 
the range — 126 to 
+ 129 bytes. 
Instruction is 
assembled to branch 
to itself. 


An operand (number 
Or expression) is out 
of range for the 
specified instruction. 
The operand is set 
equal to zero. 


A label has been used 
to identify two different 
places or represent 
two different values. 
All but the first 
definition will be 
ignored. 


A duplicate operand is 
used. 


No end statement was 
found. 


The operand field 
contains a symbol 
which has not been 
defined. A value of 0 
is used for this 
symbol. 


In the first part of Section 4, we discussed the use of the assemble command. In 
this part, we’ll discuss Assembly as a programming language. 


An assembly program is made up of source statements. Each source statement 
consists of up to four fields. A ‘‘field’’ is a range of columns on the display. 
We’ll agree to consider column 1 to be the first column of source text. Column 1 
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is the first column after a space that follows the line number. Source statements 
are written using the I (insert) command. 


| Field | Column Range 


Label 1-6 | 
Mnemonic 9-15 


Operand(s) 17-31 
Comment May begin anywhere but must be 
preceeded by a semi-colon (;). 





Labels are used to identify individual source statements. A label may be from 
one to six characters. It must start with an alphabetical character. For example: 


MOVE 

LOOP 

LOOPI 

CLS 

T1 

are all valid labels. Labels must start in column 1. 


Mnemonics are the abbreviations used to represent Z-80 operations, for example: 


LD Load 
DEC Decrement 
RET Return 


Mnemonics are also called ‘‘operation codes’’ or “‘opcodes’’ Mnemonics must 
Start in column 9. 


Operands are the values used by certain assembler statements. An operand may 
be a Z-80 register or VO port, or a one- or two-byte value. For example: 


LD Ar3 


tells the Z-80 to load into register A the number 3. ‘*A’’ and ‘‘3’’ are operands. 
Symbols may be used in place of actual numbers. For example: 


LD HL »VIDEO 


tells the z-80 to load into register HL the value for VIDEO (defined elsewhere in the 
program). The first operand must start in column 17. 


Comments document the program. They are ignored by the assembler. A 
comment may begin in any column of a source statement, subject to the 
following limitations: All comments start with a semi-colon, which tells the 
assembler to ignore the rest of the line. 


When you type in a source program, use a tab ((§) key) to separate the fields, 
not spaces. This method is faster and saves memory. Furthermore, the tab 
settings correspond to the first columns in each field. 
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Example: 

00180 5 THIS [5 A SAMPLE PROGRAM 

00110 5 

00120 sLABEL MNEM, OPERAND(S) COMMENT 

80130 ORG 32780 sFOR 16K MACHINES 

@0140 BEGIN LD HL »3C@QH s(HL)=YVIDEO RAM) 

00152 LD Ar’! 

00162 LD (HL) +A wWRITE ASTERISK TO VIDEO 
00170 RET sRETURN TO CALLER 

00182 END sEND OF SOURCE PROGRAM 


Lines 100-120 are comments. Lines 130-170 consists of assembly-language 
statements followed in most cases by comments. 


There should be one tab character at the end of each field. Spaces (entered via 
SPACEBAR) should only be used inside comments and inside character constants. 


Assembler Statements 


There are three kinds of assembler statements: 


1. Pseudo Operations. Sometimes called ‘‘pseudo ops,’ these statements are not 
translated into Z-80 object code. They control various functions of the 
assembler itself, such as defining labels, reserving memory, and setting the 
programs origination address. Pseudo ops must begin in column 9. 


2. Commands. These are also directed at the assembler. The Series I Assembler 
has two assembler commands, *LIST ON and *LIST OFF (described later). These 
commands must begin in column 1. 


3. z-80 Operations. These consist of a mnemonic (sometimes called an operation 
code or ‘‘opcode’’) sometimes followed by one, two or no operands. They 
are translated directly into object code. Some Z-80 instructions translate into 
one byte of object code; others may translate into two, three, or four bytes. 
The opcode must begin in column 9. Tabbing one time moves to column 9. 


Special Terms and Abbreviations for Operands 


nnnn or nn Represents a number. For one-byte numbers, nn is used. For 
two-byte numbers, nnnn is used. (Two-byte numbers are 
assembled into two’s complement binary values. First comes the 
least significant byte (LSB), then the most significant byte 
(MSB)). A number may be any of these: 


Decimal number 





Hexadecimal number nnnnu or nnu. The suffix ‘‘H’’ indicates 
hexadecimal; if the number starts with A-F, prefix a 0 to it, as 
IN OFOH. 


66 99 


Octal number: nnnnng or nnno. The suffix ‘‘Q”’’ or ‘‘o”’ 
indicates octal. 
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Current address, “*$’’ (The address in the program counter will 
be used in place of the $). 


Character constant: Any character inside single quotes. The 
constant is converted into its Ascii character code. For example, 
‘A’ is converted into 65. 


Any numeric expression (see *‘Expressions’’). 
Pseudo-Operations 
ORG nnnn 


(Originate) This sets the address reference counter. It determines where 
subsequent Z-80 code and data will reside in memory. If no ORG statement is 
given in your source program, the address reference counter will be set to 0. 


ORG should be used before any Z-80 instructions or data storage pseudo ops. It 
may be repeated. The programs in this manual are ORGed at decimal 32512 
(hexadecimal 7F00). All subsequent ORG’s are absolute. 


symbol EQU nnnn or nn 


(Equate) This assigns the value nnnn to the symbol. Each time the symbol is 
used as an operand in the source program, the assembler will replace it with 
nnnn. The EQU statement may appear anywhere in the program. A particular 
symbol may be equated only once. 


label DEFL nnnn 


(Define label) This assigns a temporary value nnnn to the specified label. The 
value may be changed as often as required within the source program. 


END nnnn 


This indicates the end of a source program. If there are any following lines in 
the program, they will be ignored. The address nnnn sets the entry point to the 
program. If omitted, the entry to TRSDOS (disk systems) or BASIC (cassette 
systems) will be used. For details, see section 5. 


[label] DEFB nn 


This defines the contents of the current address to be nn. This pseudo op allows 
you to initialize the contents of one-byte storage locations used by the program. 
nn may be a one-byte value or a character string enclosed in single-quotes. 


[label] DEFW nnnn 


This defines the contents of the current two-byte address to be nnnn. This 
pseudo op allows you to initialize the contents of two-byte storage locations 
used by the program. 


[label] DEFS nn 


(Define storage) This reserves nn bytes of memory, starting at the current 
address. (The reference address will be incremented by nn before the next 
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source statement is assembled.) This pseudo op allows you to reserve space for 
buffers, parameters, etc. 


[label] DEFM string 


(Define message) This stores the specified string of characters, beginning at the 
current address. 


Assembler Commands 


The *LIsT command allows you to suppress parts of a source listing. Error 
messages and the offending source statements will still be listed. These 
commands are very useful when you are debugging long programs, because the 
parts of the program already corrected do not need to be listed. You may also 
want to use them to suppress the listing of long tables of data contained in 
programs (e.g., DEFM strings). 


The asterisk (*) portion of the *LIST ON and *LIST OFF command must be in 
column one. 


*LIST OFF 

Has no effect on the assembly, but turns off the assembly listing. 

*LIST ON 

Has no effect on the assembly, but turns the assembly on again (after *LIST OFF). 
Using Expressions as Operands 


The assembler will accept an expression in place of any numeric operand. 
Expressions include symbols, numeric or string constants, and combinations 
of these using the arithmetic and logical operators listed below. 
+ and — Addition and subtraction. Example: 

LD HL +VID+8@H 


= Negation. Example: 
LD HL »VID-1 
LD HL +-1 (@ understood) 
& Logical AND. Example: 
LD Ay(HL)&@FH 
< Shift left or right. This operator shifts a value right or left by a 
specified number of bits, in this format: 
value < nn 


If nn is negative, the value is shifted to the right and zeroes fill on 
the left. If nn is positive, the value is shifted to the left and zeroes 
fill on the right. Example: 


LD ArVAL2 
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Shifts the VAL two bits to the left and fills with zeroes on the 
right. 


The Z-80 Instruction Set 


Section 6 is a full Z-80 instruction set. The Z-80 registers and flags available for 
the programmer’s use and a description of the Z-80 architecture is in Appendix F. 
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Part Five: 


Sample Programming Session 


In this section, we’ll take you step by step through the Series I Editor/ 
Assembler. Our goal will be to create a machine-language subroutine that may 
be called from a BASIC program or the disk operating system of your computer. 


The machine-language we’ll present is simple but useful. Given a source 
address, a destination address, and a length-value, it will copy a block of 
memory into another area of memory. Doing this with normal BASIC statements 
is Slow. Doing this with machine-language is almost instantaneous. 


Creating the Source Program 


Start the Editor/Assembler as explained in Section 2. Then type I to get 
into the line insertion mode. Now type in the following program, pressing 

at the end of each line. (Remember to use TAB to space from the end of 
one field to the start of the next field.) 


@010@ ; SUBROUTINE COPIES ONE BLOCK OF MEMORY TO ANOTHER AREA 
@0110 s ON ENTRY» (SRC) = SOURCE ADDRESS 


Q0120 5; (DST) = DESTINATION ADDRESS 

00130 ; (LEN) = NUMBER OF BYTES TO MOVE 

00140 ORG geZoid 

Q0150 MOVE LD HL + (SRC) 5 SOURCE ADDR. 
00162 LD DE +(DST) + DESTINATION ADDR. 
00170 LD BC »(LEN) 5 LENGTH 

00180 LDIR 

00192 RET 

@8200 SRC DEFW a 

@021@ DST DEFW 0 

@0220@ LEN DEF W 0 

00230 END MOVE 
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Press (BREAK) to quit inserting. Then type P #:* (ENTER) to see the entire source 
program. If there are any errors, use the edit mode (E command) to correct 
the line. 


If you have a printer, you may get a hard copy of the text by typing H #:* 
(ENTER). 


Now we are ready to make a copy of the source program. We’ll call it ‘‘MOVE.’’ 


Saving/Loading a Source Program (Tape Systems) 


Using a blank cassette tape, get the recorder ready to record. Type W MOVE 
(ENTER). Press again when you are ready to record. After the tape is 
recorded, the Editor/Assembler will return in the command mode (asterisk). It’s 
a good idea to make a second tape copy. 


Now try reloading the program. Delete the text from memory by typing D #:* 
(ENTER). Then rewind the recorder, prepare it to play, and type L MOVE (ENTER). 
Press again when the recorder is ready to play. After the program has 
been loaded, the Editor will return in the command mode. Now skip to the 
paragraph titled, Trial Assembly. 


Saving/Loading a Source Program (Disk Systems) 


Type W MOVE (ENTER). After the file is written, the Editor/Assembler will return 
in the command mode (asterisk). The file will be called MOVE/SRC. 


Now try reloading the source program. Delete the text from memory by typing 
D #:* (ENTER). Then type L MOVE (ENTER). After the source program has been 
loaded, the Editor will return to the command mode, listing text and memory 
contents. | 


Trial Assembly 


Now we are ready to see if the program can be assembled without errors. We'll 
use the NO (no output) and wE (wait on errors) switches for this purpose. 


The source program should be in memory. Type A +NO WE (ENTER). The Editor/ 
Assembler will put the assembly listing on the screen. If any errors are found, 
the listing will be paused. An error message will appear directly above the 
offending line. Press any key to continue. 


If any assembly errors were found, use the edit mode to correct them, and try 
another trial assembly. 


If you have a printer, you may request a hard copy of the assembly listing. This 
will be preferable to the display listing, since most listings require more than 64 
columns per line. To output to the printer, type: A »NO»LP (ENTER). 


Figure I shows the assembly listing generated by our sample program. We’ve 
added callouts to identify the various fields in the listing. 
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Memory Object Line 
Loc. Code Number Label Mnemonic Operand(s) 
02100 5; SUBROUTINE COPIES ONE BLOCK OF MEMORY TO ANOTHER AREA 
00110 5; ON ENTRY» (SRC) = SOURCE ADDRESS 
02120 ; (DST) = DESTINATION ADDRESS 
00130 ; (LEN) = NUMBER OF BYTES TO MOVE 
7FQQ aide ORG 32512 
7FOQ@ 2AQE7F 0150 MOVE LD HL » (SRC) ; SOURCE ADDR, 
7FQ3 EDSB1Q7F 2160 LD DE+(DST) 5 DESTINATION ADDR. 
7FQ7 ED4B127F 0170 LD BC »(LEN) ; LENGTH 
7F OB EDB@ 22182 LDIR 
7F@D cg 0190 RET 
7FQE 2000 20200 SRC DEFW Q 
7F1@ g2a0 00710 DST DEFW Q 
7F12 gao0 0a220 ~~ LEN DEFW Q 
7F QQ 00230 END MOVE 
22000 Total Errors 
LEN 7Fi2 
DST 7F1i@ 
SRC 7FOE 
MOVE  7FQO 
Symbol Table 


Figure 1. Sample Assembly Listing 


Here are a few comments on the source program (line references are to column 
3 of the listing): 


Line 140 sets the origination address of the program. We’ve chosen an address 
near the top of memory in a 16K RAM system. If you change this address, be sure 
to make the appropriate changes in the BAsic calling program (presented later). 


Line 230 ends the program. Since we gave an operand (MOVE), the Editor/ 
Assembler will store the value of MOVE as the entry address to the program. If 
we had omitted an operand here, the entry address to the program would have 
been set to address 0000H. (More later.) 


Object Code Output 


After confirming that the program can be assembled without errors, we are 
ready to create the object file on tape or disk. We’ll use an assemble command 
that outputs object code only. 
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Tape Systems 


Using a blank tape, prepare the recorder to record. Type A MOVE »NL »NS (ENTER). 
Press (ENTER) again when ready. The Editor/Assembler will write out the object 
tape. It’s a good idea to repeat this process to get a second tape copy. 


Disk Systems 


Type A MOVE »NL +NS (ENTER). The Editor/Assembler will create an object file 
named MOVE/CMD. 


Running the Sample Program 


Our sample program, MOVE, may be executed as a BASIC subroutine or as an 
independent program. 


First, we’ ll try it as a BASIC subroutine. 


Tape Systems (Level II and Mod III only — will not execute in a 
Level I machine) 


Start BASIC and answer the MEMORY SIZE question by typing 32511 (ENTER). This 
will keep BASIc from using the area where the subroutine will reside. 


Now load the subroutine: 


Type SYSTEM (ENTER). Prepare the recorder to play the object tape, then type 
MOVE (ENTER). After the program has been loaded, the *? will return. Press 

to return to BASIC. Now type in the BASIC program given in Listing #1. 
(Page 36) 


Run the program. Specify any source address, and specify a destination between 
15360 and 16383. Specify any length from 1 to 1024. However, the destination 
+ length must not exceed 16384. 


The program will copy a block of memory beginning at the source onto video 
memory beginning at the destination. The number of bytes copies will be the 
length value. 


Disk Systems 


Start TRSDOS. Under TRSDOS READY, load the subroutine by typing LOAD 
MOVE/CMD. 

Start BASIC. Answer the MEMORY SIZE question by typing 32511 (ENTER). This 
will keep BASIc from using the memory where MOVE resides. 

Now type in the program given in Listing 2. (Page 36) 


Run the program. Specify any source address, and specify a destination between 
15360 and 16383. Specify any length from 1 to 1024. However, the destination 
+ length must not exceed 16384. 


The program will copy a block of memory beginning at the source onto video 
memory beginning at the destination. The number of bytes copied will be the 
length value. 
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Executing a Machine-Language Program Directly 


MOVE Is a Subroutine called from a BASIC program. However, you can also 
execute machine-language programs created with the Editor/Assembler. 


Disk Systems 


Under TRSDOS READY, type in the program name and press (ENTER). The program 
will be loaded and executed, starting at the address specified in the END 
statement of the original source listing (e.g., line 230 of our sample program). 
Don’t use our sample program this way; it was designed to be called from 
BASIC only. 


Tape Systems (Level II and Mod III BASIC) 


Load the program using the SYSTEM command, as explained previously. After 
the program has been loaded from tape, the *#? will reappear. Don’t press 
(ENTER). Press / instead. The Computer will begin executing the program 
at the address specified in the END statement of the original source listing (e.g., 
line 230 of our sample program). 


Alternatively, you may type / address (ENTER) to override this entry address. 


(Don’t try this with MOVE; that subroutine should only be called from a BASIC 
program like the one we presented. ) 


Tape Systems (Level I users) 


You may load the program using the Level I ‘System Loader’ tape that came 
with your EDTASM. This is accomplished by typing CLOAD. A prompt 
‘“CASSETTE READY’’ will appear on the screen. When the tape is ready to load 
press (ENTER). Your object program will load at this time. The Computer will 
begin executing your program at the address specified in the END statement. 


You may write your own “*System Loader’’ and put it at the beginning of each 
Level I program. (Refer to Appendix B) Tapes loaded into Level I with the 
‘‘System Loader’’ must be ORGed above 4500H and be created by EDTASM. 


10 POKE 16526,0: POKE 16527:127 

20 SRC = 32526 

3@ DST = 32528 

A@ LN = 32530 

2@ CLS 

GQ INPUT "SOURCE"Ss 5 

7@ INPUT "DESTINATION": D 

8@ INPUT "LEN"s L 

90 IF (D¢13360) OR (D+16383) THEN 230 
100 VL = S: MM = SRC: GOSUB 190 

110 IF (0415360) OR (D?16383) THEN 230 
120 IF D+L =? 16384 THEN 240 

130 YL = Ds MM = DST: GOSUB 192 

140 VL = Ls: MM = LN: GOSUB 190 
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158 K = USR(Q@) 

160 IF INKEY$="" THEN 160 

178 GOTO 5@ 

180 ‘BREAK NUMBER INTO MSB; LSB 

190 M54 = YL/256: LS% = VL - (MS% * 256) 

200 ‘PUT DATA INTO MEMORY 

21Q@ POKE MM+ LS%: POKE MM+1» MS% 

22@ RETURN 

23@ PRINT "INVALID DESTINATION": STOP 

248 PRINT "DATA BLOCK EXCEEDS END OF YIDEO RAM": STOP 


Listing #1. 


10 DEFUSR = &H7FQ@ 
28 SRC = &H7FOE 


3@ DST = &H7F1Q@ 
40 LN = &H7F12 
08 CLS 


G@ INPUT "SOURCE"; § 

708 INPUT "DESTINATION"S D 

8@ INPUT "LEN"S L 

98 IF (D<£15360) OR (D?16383) THEN 232 
100 YL = S: MM= SRC: GOSUB 190 

110 IF (D¢15360) OR (0216383) THEN 230 
120 IF D+L > 16384 THEN 242 

13@ YL = Ds: MM = DST: GOSUB 190 

140 YL = L: MM = LN: GOSUB 198 

158 k = USR(@) 

160 IF INKEY$="" THEN 162 

178 GOTO 30 

18@ ‘BREAK NUMBER INTO MSB; LSB 

190 MS4 = VL/256: LSZ = VL - (MSZ * 256) 
280 ‘PUT DATA INTO MEMORY 

Z21Q@ POKE MM» LSAZ: POKE MM+1i» MS% 

228 RETURN 

230 PRINT "INVALID DESTINATION": STOP 
248 PRINT "DATA BLOCK EXCEEDS END OF VIDEO RAM": STOP 


Listing #2. 
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Part Six: 
The Z-80 Instruction Set 


Notation and Other Conventions 


This section includes a detailed description of all the z-80 assembly language 
instructions. The first line of each of these pages shows the assembly language 
opcode mnemonic followed by its operand(s). Some instructions have no 
operands at all. Other instructions have one or two operands. Anything which 
is capitalized should be copied exactly when you use the editor to write the 
assembly language source code. Anything shown in lowercase letters will be 
replaced by an appropriate register, number, or label. For example, the first 
instruction described in the eight-bit load group is: 


LD r,r'’ 


LD is the mnemonic for the Load instruction. If you wish to move the contents 
of register H into register A, the actual source code is 


LD A,H 





This should be read as ‘‘load register A with the contents of register H.”’ 


A detailed explanation of the operand notation is given below, but in general 
you should note that single lowercase letters are used for eight-bit numbers or 
registers and double lowercase letters are used for 16-bit numbers or registers. 
Also note that parentheses around a register pair indicates that the register pair is 
to be used as a pointer to a memory location. For example, the instruction INC 
HL means that | is to be added to the HL register pair. The instruction INC (HL) 
means that 1 will be added to a number in memory whose address is found in 
register pair HL. 


Symbol Specifies one of the registers 
r A, B,C, D, E, H, Or L. 

Symbol Specifies a register pair 

qq BC, DE, HL, or AF 

SS BC, DE, HL, or SP 

dd BC, DE, HL, or SP 

pp BC, DE, IX, or SP 


rr BC, DE, IX, Or SP 
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Symbol Specifies a number or symbol in the range 
n 0 to 255 (one byte) 

nn 0 to 65535 (two bytes) 

d — 128 to 127 (one byte) 

e — 126 to 129 (one byte) 

Symbol Specifies any of the following 

S r, n, (HL), (Ix +d), or (ly +d) 

m r, (HL) (IX+4d), or (IY +d) 

(nn) Specifies the contents of memory location nn 
b Specifies an expression in the range (0,7) 

cc Specifies the state of the Flags for conditional Jr, JP, CALL and 


RET instructions 


Instruction Format Examples With Explanation 


Format Example 1 


LD (HL) 


Operation: fF 4 (HL) 


This is the shorthand description of the instruction. The arrow indicates that data 
is moved into register r. 


When you write the assembly language code, the lowercase r will be replaced 
by A, B, C, D, E, H or L. 


Format: 
Mnemonic: LD Operands: r,(HL) 


Object Code: 
O 1 r r sr 1 1 90 
The object code for this instruction is one byte long. To figure out the object 


code, replace bits 3, 4 and 5 with the appropriate numbers from the table. For 
example: 


Source Code Object Code 
LD A,(HL) 01111110 
LD B,(HL) 01000110 
LD C,(HL) 01001110 
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This instruction uses two machine (M) cycles. The first machine cycle consists 
of four timing (T) states and the second machine cycle consists of three T states 
for a total of seven T states. In the TRS-80 one T state takes .5636714 
microseconds because the clock speed is 1.774038 MHz, for Model I, 4 MHz 
for Model II and 2.02752 MHz for Model III. The execution time (E.T.), in 
microseconds, is calculated for the TRS-80. (One microsecond is 10~° seconds 
or 1/1,000,000 of a second.) 


Description: 


The eight-bit contents of memory location (HL) are loaded into register r, where 
r identifies register A, B, C, D, E, H or L, assembled as follows in the object 


code: 

Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 


M cycles: 2 T states: 7(4,3) 4 MHz E.T:: 1.75 
Condition Bits Affected: None 


Example: 

If register pair HL contains the number 75A1H, and memory address 75 AlH 
contains the byte 58H, the execution of 

LD C, (HL) 

will result in 58H in register C. 


Format Example 2 


JP cc,nn 
Operation: IF cc TRUE, PC Ginn 


The jump is made only if the condition cc is true. The arrow indicates that the 
number nn is moved into the program counter PC. This will cause the program 
to jump to address nn. 

When you write the assembly language code, cc will be replaced by one of the 
following: NZ, Z, NC, C, PO, PE, P or M. nn will be replaced by a number 
from 0 to 65535 or a label. 
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hes 
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Mnemonic: JP Operands: cc, nn 
Object Code: 


1 1 ce ce cc O 1 O 


Note: The first n operand in this assembled object code is the low order byte of 
a two-byte memory address. 


The object code for this instruction is three bytes long. To figure out the object 
code, replace bits 3, 4 and 5 of the first byte with the appropriate number from 
the table. The second two bytes of the object code are the address being jumped 
to. For example: 


Source Code Object Code 


JP NZ, OFFOOH 11000010 C2H 
00000000 0H 
11111111 FFH 

JP M, 1002H 11111010 FAH 
00000010 02H 
00010000 10H 


Note that the low order, or right hand byte, of the address comes first in the 
object code. 


Description: 


If condition cc is true, the instruction loads operand nn into register pair PC 
(Program Counter), and the program continues with the instruction beginning at 
address nn. If condition cc is false, the Program Counter is incremented as 
usual, and the program continues with the next sequential instruction. Condition 
cc is programmed as one of eight status bits which correspond to condition bits 
in the Flag Register (register F). These eight status bits are defined in the table 
below which also specifies the corresponding cc bit fields in the assembled 
object code. 


The Relevant Flag column shows the value the flag must have if the jump is to 
occur. 


aN 


0 
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Relevant 
cc Condition Flag 
000 NZ non zero Z =0 
001 Z zero Z =1 
010 NC no carry C =0 
011 C carry C =1 
100 PO parity odd or no overflow P/V = 0 
101 PE parity even or overflow P/V = 1 
110 P sign positive S =90 
111 M sign negative S =1 


M cycles: 3 T states: 10(4,3,3) 4 MHz E.T.: 2.50 
Condition Bits Affected: None 


Example: 

If the Carry Flag (C flag in the F register) is set and the contents of address 1520 
are 03H, after the execution of 

JP C,1520H 


the Program Counter will contain 1520H, and on the next machine cycle the 
CPU will fetch from address 1520H the byte 03H. In other words, program 
execution jumps to the instruction at 1520H. 


Format Example 3 





CPIR 


Operation: A— (HL), HLGHL+ 1, BO GBC — 1 


The shorthand description indicates that three different things are happening: 
1. BC is decremented 
2. HL is incremented 


3. A byte in memory is subtracted from the A register (but the results are not 
saved). 


Format: 


Mnemonic: CPIR Operands: 
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Object Code: 
1 1 1 0 1 21 0 =41 ED 
1 O 1 1 0 0 0 41 Bl 


The assembly language instruction has no operands. 
The object code is two bytes long. 


Description: 


The contents of the memory location addressed by the HL register pair is 
compared with the contents of the Accumulator. In case of a true compare, a 
condition bit is set. The HL is incremented and the Byte Counter (register 

pair BC) is decremented. If decrementing causes the BC to go to zero or if 
A=(HL), the instruction is terminated. If BC is not zero and A#(HL), the 
program counter is decremented by 2 and the instruction is repeated. Note that if 
BC is set to zero before the execution, the instruction will loop through 64K 
bytes, if no match is found. Also, interrupts will be recognized after each data 
comparison. 


For BC #@ and A#(HL): 

M cycles: 5 T states: 21(4,4,3,5,5) 4 MHz E.T.: 5.25 
For BC=90 or A=(HL): 

M cycles: 4 T states: 16(4,4,3,5) 4 MHz E.T.: 4.00 


The total execution time of this instruction depends on how long it takes to find 
the byte being searched for and the length of the block being searched. If the 
instruction loops three times before BC =9 or A=(HL), then there will be 58 
(2x21 + 16) timing (T) states executed. 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if A = (HL); reset otherwise 

H: Set if borrow from Bit 4; reset otherwise 
P/V: Set if BC becomes zero; reset otherwise 
N: Set 

C: Not affected 

Example: 


If the HL register pair contains 1111H, the Accumulator contains F3H, the Byte 
Counter contains 0007H, and memory locations have these contents: 


(14111H) : 52H 
(1112H) : OOH 
(1113H) : F3H 
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then after the execution of 
CPIR 


the contents of register pair HL will be 1114H, the contents of the Byte Counter 
will be 0004H. Since BC #9, the P/V flag is still set. This means that it did not 
search through the whole block before the instruction stopped. Since a match 
was found, the Z flag is set. 


The CPIR instruction will affect five of the six condition codes. 
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§ Bit Load Group | 


LD rr’ LoaD 


Operation: r dr’ 


Format: 


Mnemonic: LD Operands: r, r’ 


Object Code: 


/ / 


0 1 r sr sr sr yr fr 


Description: 


The contents of any register r’ are loaded into any other register r. Note: r, r’ 
identifies any of the registers A, B, C, D, E, H, or L, assembled as follows in 
the object code: 


Register r,r’ 
A = 111 
B = 000 
C = 001 
D = 010 
E = O11 
H = 100 
L = 101 


M cycles: 1 T states: 4 4 MHz E.T:: 1.0 
Condition Bits Affected: None 


Example: 


If the H register contains the number 8AH, and the E register contains 10H, the 
instruction 


LD HE 


would result in both registers containing 10H. 
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LD rn LoaD 


Operation: rn 


Format: 


Mnemonic: LD Operands: r, n 


Object Code: 


0 O r r r 1 1 0 


Description: 


The eight-bit integer n is loaded into any register r, where r identifies register A, 
B, C, D, E, H or L, assembled as follows in the object code: 


Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 


M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 
Condition Bits Affected: None 


Example 1: 


After the execution of 
LD E,ASH 
the contents of register E will be ASH. 


Example 2: 


After the execution of 
LD A,O 
register A will contain zero. 
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LD 6(A L) LoaD 


Operation: r 4 (HL) 

Format: 

Mnemonic: LD Operands: r, (HL) 
Object Code: 


0 1 r sr esredt dtd 0 


Description: 


The eight-bit contents of memory location (HL) are loaded into register r, where 
r identifies register A, B, C, D, E, H or L, assembled as follows in the object 
code: _ 


Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
LL. = 101 
M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 


Condition Bits Affected: None 


Example: 


If register pair HL contains the number 75A1H, and memory address 75A1H 
contains the byte 58H, the execution of 


LD C,(HL) 
will result in 58H in register C. 


LD 6(IX alr d) LoaD 


Operation: r (IX + d) 


Format: 


Mnemonic: LD Operands: r, (IX + d) 
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Object Code:. 


d ddddaddéeq4d 


Description: 


The operand (LX + d) (the contents of the Index Register IX summed with a 
displacement integer d) is loaded into register r, where r identifies register A, B, 
C, D, E, H or L, assembled as follows in the object code: 


Register or 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L. = 101 


M cycles: 5 T states: 19(4,4,3,5,3) 4 MHz E.T:: 4.75 
Condition Bits Affected: None 


Example: 


If the Index Register IX contains the number 25AFH, the instruction 
LD B,IX-+ 19H) 


will cause the calculation of the sum 25AFH + 19H, which points to memory 
location 25C8H. If this address contains byte 39H, the instruction will result in 
register B also containing 39H. 


A typical use of this instruction is shown below. If TABL is a location in 
memory this program will load the first four bytes of the table into registers A, 
B, C and D. 


LD IX, TABL ; [IX points to the table 
LD A, (IX +0) ; Load first byte 

LD B, IX +1) ; Load second byte 
LD C, IX + 2) ; Load third byte 

LD D, (IX + 3) ; Load fourth byte 


on 
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LD r (IY +d) Load 


Operation: r (IY + d) 


Format: 


Mnemonic: LD Operands: r, (IY + d) 


Object Code: 


d dddddqdéq4qd 


Description: 


The operand (IY + d) (the contents of the Index Register TY summed with a 
two’s complement displacement integer d) is loaded into register r, where r 
identifies register A, B, C, D, E, H, or L, assembled as follows in the object 


~ Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 


M cycles: 5 T states: 19(4,4,3,5,3) 4 MHz E.T:: 4.75 
Condition Bits Affected: None 


Example: 
If the Index Register [Y contains the number 25AFH, the instruction 
LD B,(IY+ 19H) 


will cause the calculation of the sum 25AFH + 19H, which points to memory 
location 25C8H. If this address contains byte 39H, the instruction will result in 
register B also containing 39H. 
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LD (H L) iT LoaD 
Operation: (HL) dr 


Format: 
Mnemonic: LD Operands: (HL), r 


Object Code: 


0 1 1 1 O r sr rr 


Description: 


The contents of register r are loaded into the memory location specified by the 
contents of the HL register pair. The symbol r identifies register A, B, C, D, E, 
H or L, assembled as follows in the object code: 


Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 


M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 
Condition Bits Affected: None 


Example: 


If the contents of register pair HL specify memory location 2146H, and the B 
register contains the byte 29H, after the execution of 


LD (HL),B 
memory address 2146H will also contain 29H. 


LD (IX+d),r Load 


Operation: (IX +d) dr 


Format: 


Mnemonic: LD Operands: (IX +d), r 
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Object Code: 


d ddddddé4@4d 


Description: 


The contents of register r are loaded into the memory address specified by the 
contents of Index Register IX summed with d, a two’s complement displacement 
integer. The symbol r identifies register A, B, C, D, E, H or L, assembled as 
follows in the object code: 


Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 


M cycles: 5 T states: 19(4,4,3,5,3) 4 MHz E.T.: 4.75 
Condition Bits Affected: None 


Example: 





If the C register contains the byte 1CH, and the Index Register [X contains 
3100H, then the instruction 


LD (IX+6H), C 


will perform the sum 3100H + 6H and will load 1CH into memory location 
3106H. 


LD (IY+4d),r LoaD 


Operation: (IY +d) Gr 


Format: 


Mnemonic: LD Operands: (IY+d), r 
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Object Code: 


FD 


d dddddqdéq4d 
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Description: 


The contents of register r are loaded into the memory address specified by the 
sum of the contents of the Index Register IY and d, a two’s complement 
displacement integer. The symbol r is specified according to the following table. 


Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 


M cycles: 5 T states: 19(4,4,3,5,3) 4 MHz E.T.: 4.75 
Condition Bits Affected: None 


Example: 


If the C register contains the byte 48H, and the Index Register IY contains 
2A11H, then the instruction 


LD (1Y+4H),C 


will perform the sum 2A11H +4H, and will load 48H into memory location 
2A15. 


LD (A L),n LoaD 


Operation: (HL) dn 


Format: 
Mnemonic: LD Operands: (HL), n 





on 
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Description: 


Integer n is loaded into the memory address specified by the contents of the HL 
register pair. 


M cycles: 3 T states: 10(4,3,3) 4 MHz E.T.: 2.50 
Condition Bits Affected: None 


Example: 


If the HL register pair contains 4444H, the instruction 
LD (HL),28H 
will result in the memory location 4444H containing the byte 28H. 


LD (IX +d),n oad 


Operation: (IX +d) @n 


Mnemonic: LD Operands: (IX +d), n 


Object Code 
1 1 0O 1 1 1 +0 = 41 DD 
0 0 1 1 0 1 +21 ~=«0 36 
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Description: 


The n operand is loaded into the memory address specified by the sum of the 
contents of the Index Register IX and the two’s complement displacement 


M cycles: 5 T states: 19(4,4,3,5,3) 4 MHz E.T.: 4.75 
Condition Bits Affected: None 


Example: 


If the Index Register [IX contains the number 219AH the instruction 
LD (IX+5H),5AH 


would result in the byte SAH in the memory address 219FH. 
(219FH = 219AH + 5H.) 


LD (IY + d),n LoaD 


Operation: (TY + d) an 


Mnemonic: LD Operands: (1Y+d), n 


Object Code 
1 1 21 1 #21 ~=21 ~0~=1 FD 
0 0 1 1 0 1 1 ~=~0 36 


Description: 


Integer n is loaded into the memory location specified by the contents of the 
Index Register summed with a two’s complement displacement integer d. 


M cycles: 5 T states: 19(4,4,3,5,3) 4 MHz E.T.: 4.75 


Condition Bits Affected: None 


oO 








8 BIT LOAD GROUP 


Example: 


If the Index Register [TY contains the number A94QH, the instruction 
LD (IY+10H),97H 
would result in byte 97H in memory location A95QH. 


LD A, (BC) LoaD 
Operation: A4 (BC) 


Format: 


Mnemonic: LD Operands: A, (BC) 
Object Code: 


0 0 0 0 1 0 1 =O OA 


Description: 


The contents of the memory location specified by the contents of the BC register 
pair are loaded into the Accumulator. 


M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 
Condition Bits Affected: None 


Example: 


If the BC register pair contains the number 4747H, and memory address 4747H 
contains the byte 12H, then the instruction 


LD A,(BC) 
will result in byte 12H in register A. 


LD A,(DE) Loa 


Operation: A (DE) 


Format: 


Mnemonic: LD Operands: A, (DE) 
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Object Code: 


0 0 0 1 1 0 1 =O 1A 


Description: 


The contents of the memory location specified by the register pair DE are loaded 
into the Accumulator. 


M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 
Condition Bits Affected: None 


Example: 


If the DE register pair contains the number 30A2H and memory address 30A2H 
contains the byte 22H, then the instruction 


LD A,(DE) 
will result in byte 22H in register A. 


LD A,(nn) LoaD 


Operation: A (nn) 


Format: 


Mnemonic: LD Operands: A, (nn) 
Object Code: 


3A 


© 
© 
— 
— 
— 
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— 
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Description: 


The contents of the memory location specified by the operands nn are loaded 
into the Accumulator. The first n operand is the low order byte of a two-byte 
memory address. 


M cycles: 4 T states: 13(4,3,3,3) 4 MHz E.T.: 3.25 
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Condition Bits Affected: None 


Example: 


If the contents of memory address 8832H is byte 04H, after the instruction 
LD A,(8832H) 
byte 04H will be in the Accumulator. 


LD (BC) A LoaD 
Operation: (BC) GA 


Format: 
Mnemonic: LD Operands: (BC), A 


Object Code: 


0 0 0 0 0 0 1 =O Q2 


Description: 


The contents of the Accumulator are loaded into the memory location specified 
by the contents of the register pair BC. 


M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 
Condition Bits Affected: None 


Example: 


If the Accumulator contains 7AH and the BC register pair contains 1212H the 
instruction 


LD (BC),A 
will result in 7AH being in memory location 1212H. 


LD (DE),A LoaD 
Operation: (DE) OA 


Format: 


Mnemonic: LD Operands: (DE), A 
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Object Code: 


0 0 0 1 0 0 1 +0 12 


Description: 


The contents of the Accumulator are loaded into the memory location specified 
by the DE register pair. 


M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 
Condition Bits Affected: None 


Example: 


If the contents of register pair DE are 1128H, and the Accumulator contains byte 
AQH, the instruction 


LD (DE),A 
will result in AQH being in memory location 1128H. 


LD (nn),A LoaD 


Operation: (NN) GA 


Format: 


Mnemonic: LD Operands: (nn), A 


Object Code: 


Description: 


The contents of the Accumulator are loaded into the memory address specified 
by the operands nn. The first n operand in the assembled object code above is 
the low order byte of nn. 


M cycles: 4 T states: 13(4,3,3,3) 4 MHz E.T.: 3.25 
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Condition Bits Affected: None 


Example: 


If the contents of the Accumulator are byte D7H, after the execution of 
LD (3141H),A 
D7H will be in memory location 3141H. 


LD A\| LoaD 


Operation: A ¢| 


Format: 


Mnemonic: LD Operands: A, I 


Object Code: 
1 1 1 0 1 21 0 = 1 ED 
0 1 0 1 0 1 1 ~=«41 57 
Description: 


The contents of the Interrupt Vector Register I are loaded into the Accumulator. 
M cycles: 2 T states: 9(4,5) 4 MHz E.T.: 2.25 


Condition Bits Affected: 


S: Set if I-Reg. is negative; reset otherwise 
Z: Set if I-Reg. is zero; reset otherwise 

H: Reset 

P/V: Contains contents of IFF2 

N: Reset 

C: Not affected 


Note: If an interrupt occurs during execution of this instruction, the Parity flag 
will contain a 0. 
Example: 


If the Interrupt Vector Register contains the byte 4AH, after the execution of 
LD A,I 
the accumulator will also contain 4AH. 
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LD A,R LoaD 


Operation: AGR 


Format: 


Mnemonic: LD Operands: A, R 


Object Code: 
1 1 1 0 1 1 +40 =41 ED 
0 1 0 1 1 1 1 ~41 SF 
Description: 


The contents of Memory Refresh Register R are loaded into the Accumulator. 


M cycles: 2 T states: 9(4,5) 4 MHz E.T.: 2.25 


Condition Bits Affected: 


S: Set if R-Reg. is negative; reset otherwise 
Z: Set if R-Reg. is zero; reset otherwise 

H: Reset 

P/V: Contains contents of [FF2 

N: Reset 

C: Not affected 

Example: 


If the Memory Refresh Register contains the byte 4AH, after the execution of 
LD A,R 
the Accumulator will also contain 4AH. 


LD IA 


Operation: | GA 


Format: 


Mnemonic: LD Operands: I, A 
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1 1 1 0 1 1 +0 =1 ED 
0 10 0 0 1 1 =41 47 
Description: 


The contents of the Accumulator are loaded into the Interrupt Control Vector 
Register, I. 


M cycles: 2 T states: 9(4,5) 4 MHz E.T.: 2.25 
Condition Bits Affected: None 


Example: 


If the Accumulator contains the number 81H, after the instruction 
LD IA 
the Interrupt Vector Register will also contain 81H. 


LD R,A LoaD 


Operation: RGA 


Format: 


Mnemonic: LD Operands: R, A 


Object Code: 
1 1 1 0 1 1 0 =1 ED 
0 1 0 0 1 1 1 ~=1 4F 
Description: 


The contents of the Accumulator are loaded into the Memory Refresh register R. 


M cycles: 2 T states: 9(4,5) 4 MHz E.T.: 2.25 


Condition Bits Affected: None 
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Example: 


If the Accumulator contains the number B4H, after the instruction 
LD R,A 
the Memory Refresh Register will also contain B4H. 
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16 Bit Load Group 
LD dd,nn LoaD 


Operation: dd (nn 


Format: 


Mnemonic: LD Operands: dd, nn 
Object Code: 


0 0 ddo0O oO 0 1 


Description: 


The two-byte integer nn is loaded into the dd register pair, where dd defines the 
BC, DE, HL, or SP register pairs, assembled as follows in the object code: 


Pair dd 
BC 00 
DE 01 
HL 10 
SP 11 


The first n operand in the assembled object code is the low order byte. 


Mcycles:3 _—_‘T states: 10(4,3,3) 4 MHzET.: 2.50 
Condition Bits Affected: None 


Example: 


After the execution of 
LD HL,5000H 
the contents of the HL register pair will be SQQ0QH. 
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After the execution of 
LD BC,2501H 
the BC register will contain 2501H. 


LD X,nn LoaD 


Operation: IX (nn 


Format: 


Mnemonic: LD Operands: IX, nn 


Object Code: 
1 1 0 1 41 21 #0 = =1 DD 
0 0 1 0 0 0 0 41 21 


Description: 


Integer nn is loaded into the Index Register [X. The first n operand in the 
assembled object code above is the low order byte. 


M cycles: 4 T states: 14(4,4,3,3) 4 MHz E.T.: 3.50 
Condition Bits Affected: None 


Example: 


After the instruction 
LD IX,45A2H 
the Index Register will contain integer 45A2H. 
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16 BIT LOAD GROUP 





LD Y,, nn LoaD 


Operation: lY (nn 


Format: 


Mnemonic: LD Operands: IY, nn 


Object Code: 
1 1 1 721 =71 21 ~=0 ~=41 FD 
0 0 10 0 0 0 =41 21 


Description: 


Integer nn is loaded into the Index Register IY. The first n operand in the 
assembled object code above is the low order byte. 


M cycles: 4 T states: 14(4,4,3,3) 4 MHz E.T.: 3.50 
Condition Bits Affected: None 


Example: 


After the instruction: 
LD IY,7733H 
the Index Register IY will contain the integer 7733H. 


LD HL,(nn) LoaD 


Operation: HG@(nn + 1), L4(nn) 


Format: 


Mnemonic: LD Operands: HL, (nn) 
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0 0 1 0 1 0 1 =0 2A 


first n operand in the assembled object code above is the low order byte of nn. 
M cycles: 5 T states: 16(4,3,3,3,3) 4 MHz E.T.: 4.00 


Condition Bits Affected: None 


Example: 


If address 4545H contains 37H and address 4546H contains A1lH, after the 
instruction 


LD HL,(4545H) 
the HL register pair will contain A137H. 


LD dd,(nn) LoaD 


Operation: dd, 4(nn + 1), dd, (nn) 


Format: 
Mnemonic: LD Operands: dd, (nn) 


Object Code: 


©) 
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16 BIT LOAD GROUP 
SESS SR IF EN 


Description: 


The contents of address nn are loaded into the low order portion of register pair 
dd, and the contents of the next highest memory address (nn + 1) are loaded 
into the high order portion of dd. Register pair dd defines BC, DE, HL, or SP 
register pairs, assembled as follows in the object code: 


Pair dd 
BC 00 
DE 01 
HL 10 
SP 11 


The first n operand in the assembled object code above is the low order byte of 
(nn). 


M cycles: 6 T states: 20(4,4,3,3,3,3) 4 MHz E.T.: 5.00 
Condition Bits Affected: None 


Example 1: 


If Address 2130H contains 65H and address 2131M contains 78H after the 
instruction 


LD BC,(2130H) 
the BC register pair will contain 7865H. 


Example 2: 


If address FFFE contains 01H and address FFFF contains 02H, then after the 
instruction 


LD SP,(QFFFEH) 
the SP will contain 0201H. 


LD IX,(nn) LoaD 


Operation: IX, (nn + 1), IX, @(nn) 


Format: 


Mnemonic: LD Operands: IX, (nn) 
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Object Code: 
1 1 0 1 1 1 +0 41 DD 
0 0 1 0 1 0 1 +0 2A 


Description: 


The contents of the address nn are loaded into the low order portion of Index 
Register IX, and the contents of the next highest memory address (nn + 1) are 
loaded into the high order portion of IX. The first n operand in the assembled 
object code above is the low order byte of nn. 


M cycles: 6 T states: 20(4,4,3,3,3,3) 4 MHz E.T.: 5.00 
Condition Bits Affected: None 


Example: 


If address 6066H contains 92H and address 6067H contains DAH, after the 
instruction 


LD IX,(6066H) 
the Index Register [IX will contain DA92H. 


LD TY,(nn) LoaD 


Operation: IY, 4 (nn + 1), IY, @(nn) 


Mnemonic: LD Operands: [Y, (nn) 
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16 BIT LOAD GROUP 


0 0 1 0 1 0 1 +9 2A 


Description: 


The contents of address nn are loaded into the low order portion of Index 
Register IY, and the contents of the next highest memory address (nn + 1) are 
loaded into the high order portion of [Y. The first n operand in the assembled 
object code above is the low order byte of nn. 


M cycles: 6 T states: 20(4,4,3,3,3,3) 4 MHz E.T:: 5.00 
Condition Bits Affected: None 


Example: 


If address 6666H contains 92H and address 6667H contains DAH, after the 
instruction 


LD _IY,(6666H) 
the Index Register TY will contain DA92H. 


LD (nn),AL LoaD 


Operation: (NN + 1) GH, (nn) aL 


Format: 


Mnemonic: LD Operands: (nn), HL 
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Object Code: 


Description: 


The contents of the low order portion of register pair HL (register L) are loaded 
into memory address nn, and the contents of the high order portion of HL 
(register H) are loaded into the next highest memory address (nn + 1). The first 
n operand in the assembled object code above is the low order byte of nn. © 


M cycles: 5 T states: 16(4,3,3,3,3) 4 MHz E.T.: 4.00 
Condition Bits Affected: None 


Example 1: 


If the content of register pair HL is 483AH, after the instruction 
LD (B229H),HL 
address B229H will contain 3AH, and address B22AH will contain 48H. 


Example 2: 


If the register pair HL contains 504AH, then after the instruction 

LD (PLACE),HL 

the address PLACE will contain 4AH and address PLACE + 1 will contain 50H. 
Note: PLACE is a label which must be defined elsewhere in the program. 


LD (nn),dd LoaD 


Operation: (NN + 1) ddd,, (nn) ddd, 


Format: 


Mnemonic: LD Operands: (nn), dd 








16 BIT LOAD GROUP 
Ne ee 


Object Code: 


Description: 


The low order byte of register pair dd is loaded into memory address (nn); the 
upper order byte is loaded into memory address (nn + 1). Register pair dd 
defines either BC, DE, HL, or SP, assembled as follows in the object code: 


Pair dd 
BC 00 
DE 01 
HL 10 
SP 11 


The first n operand in the assembled object code is the low order byte of a two 
byte memory address. 


M cycles: 6 T states: 20(4,4,3,3,3,3) 4 MHz E.T.: 5.00 
Condition Bits Affected: None 


Example: 


If register pair BC contains the number 4644H, the instruction 
LD (1000H),BC 


will result in 44H in memory location 100QH, and 46H in memory 
location 1001H. 


LD (nn),IX LoaD 


Operation: (NN + 1) GIX,, (nn) GX, 


Format: 


Mnemonic: LD Operands: (nn), IX 


73 








SERIES | EDITOR/ASSEMBLER 


1 1 0 1 1 1 0 1 DD 


Description: 


The low order byte in Index Register [X is loaded into memory address nn; the 
upper order byte is loaded into the next highest address (nn + 1). The first n 
operand in the assembled object code above is the low order byte of nn. 


M cycles: 6 T states: 20(4,4,3,3,3,3) 4 MHz E.T.: 5.00 
Condition Bits Affected: None 


Example: 


If the Index Register IX contains 5A3QH, after the instruction 
LD (4392H),IX 


memory location 4392H will contain number 30H and location 4393H will 
contain SAH. 


LD (nn),lY LoaD 


Operation: (NN + 1) GIY,, (nn) aly, 


Format: 


Mnemonic: LD Operands: (nn), [Y 
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Description: 


The low order byte in Index Register IY 1s loaded into memory address nn; the 
upper order byte is loaded into memory location (nn + 1). The first n operand in 
the assembled object code above is the low order byte of nn. 


M cycles: 6 T states: 20(4,4,3,3,3,3) 4 MHz E.T.: 5.00 
Condition Bits Affected: None 


Example: 


If the Index Register IY contains 4174H after the instruction 
LD 8838H,IY 


memory location 8838H will contain number 74H and memory location 8839H 
will contain 41H. 


LD SPHL LoaD 


Description: 


The contents of the register pair HL are loaded into the Stack Pointer SP. 
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M cycles: 1 T states: 6 4 MHz E.T.: 1.50 
Condition Bits Affected: None 


Example: 


If the register pair HL contains 442EH, after the instruction 
LD SP,HL 
the Stack Pointer will also contain 442EH. 


LD SP. IX LoaD 


Operation: SP (1X 


Format: 


Mnemonic: LD Operands: SP, IX 


Object Code: 
1 1 0 1 1 #21 #0 =41 DD 
1 1 1 1 #21 0 0 1 F9 
Description: 


The two-byte contents of Index Register [X are loaded into the Stack Pointer SP. 


M cycles: 2 T states: 10(4,6) 4 MHz E.T.: 2.50 
Condition Bits Affected: None 


Example: 


If the contents of the Index Register [IX are 98DAH, after the instruction 
LD SP,IX 
the contents of the Stack Pointer will also be 93DAH. 
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16 BIT LOAD GROUP 





LD SP. lY LoaD 


Operation: SPAY 


Format: 


Mnemonic: LD Operands: SP, IY 


Object Code: 
1 ft 1 1 1 +21 ~=0~=«1 FD 
1 1 1 1 #21 +40 0 = 1 F9 
Description: 


The two byte contents of Index Register IY are loaded into the Stack Pointer SP. 
M cycles: 2 T states: 10(4,6) 4 MHz E.T.: 2.50 


Condition Bits Affected: None 


Example: 


If Index Register IY contains the integer A227H, after the instruction 
LD SP,IY 
the Stack Pointer will also contain A227H. 


PUSH aq 


Operation: (SP — 2) daq,, (SP — 1) daqy 


Format: 


Mnemonic: PUSH Operands: qq 


Object Code: 


1 1qq0i1041 
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Description: 


The contents of the register pair qq are pushed into the external memory LIFO 
(last-in, first-out) Stack. The Stack Pointer (SP) register pair holds the 16-bit 
address of the current “‘top’’ of the Stack. This instruction first decrements the 
SP and loads the high order byte of register pair qq into the memory address 
now specified by the SP, then decrements the SP again and loads the low order 
byte of qq into the memory location corresponding to this new address in the 
SP. The operand qq means register pair BC, DE, HL, or AF, assembled as 
follows in the object code: 


Pair qq 
BC 00 
DE 01 
HL 10 
AF 11 


M cycles: 3 T states: 11(5,3,3) 4 MHz E.T.: 2.75 
Condition Bits Affected: None 


Example: 


If the AF register pair contains 2233H and the Stack Pointer contains 1007H, 
after the instruction 

PUSH AF 

memory address 1006H will contain 22H, memory address 1005H will contain 
33H, and the Stack Pointer will contain 1005H. In other words the number from 
register pair AF is now on the top of the stack, and the stack pointer is pointing 
to it. 


Before: 
Register AF Address Stack 
2233 1007 FF 
1008 35 
Stack Pointer 
1007 


After: PUSH AF 
Register AF Address Stack 


2233 1005 33 
1006 22 
1007 FF 
1008 35 


Stack Pointer 
1005 
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PUSH IX 
Operation: (SP —2)41X, (SP —1)41X, 


Format: 
Mnemonic: PUSH Operands: [X 


Object Code: 
1 1 0 1 21 21 +0 = 41 DD 
1 1 1 0 0 1 +0 = =41 ES 
Description: 


The contents of the Index Register [X are pushed into the external memory 
LIFO (last-in, first-out) Stack. The Stack Pointer (SP) register pair holds the 
16-bit address of the current “‘top’’ of the Stack. This instruction first 
decrements the SP and loads the high order byte of IX into the memory address 
now specified by the SP, then decrements the SP again and loads the low order 
byte into the memory location corresponding to this new address in the SP. 


M cycles: 3 T states: 15(4,5,3,3) 4 MHz E.T.: 3.75 
Condition Bits Affected: None 


Example: 


If the Index Register [IX contains 2233H and the Stack Pointer contains 1007H, 
after the instruction 
PUSH IX 


memory address 1006H will contain 22H, memory address 1005H will contain 
33H, and the Stack Pointer will contain 1005H. The number from the [X 
register pair is now on the top of the stack. 


Before: 


Register IX Address Stack 


2233 1007 FF 
1008 35 
Stack Pointer 
1007 
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After: PUSH IX 
Register IX Address Stack 


2233 1005 33 
1006 22 
1007 FF 
1008 35 
Stack Pointer 
1005 


PUSH IY 
Operation: (SP — 2) GIY,, (SP — 1) Gl¥, 


Format: 
Mnemonic: PUSH Operands: IY 


Object Code: 
1 1 1 71 #21 +21 +0 = 1 FD 
1! 1 1 0 0 1 0 = 1 ES 
Description: 


The contents of the Index Register [TY are pushed into the external memory 
LIFO (last-in, first-out) Stack. The Stack Pointer (SP) register pair holds the 
16-bit address of the current “‘top’’ of the Stack. This instruction first 
decrements the SP and loads the high order byte of IY into the memory address 
now specified by the SP; then decrements the SP again and loads the low order 
byte into the memory location corresponding to this new address in the SP. 


M cycles: 4 T states: 15(4,5,3,3) 4 MHz E.T.: 3.75 
Condition Bits Affected: None 


Example: 


If the Index Register TY contains 2233H and the Stack Pointer contains 1007H, 
after the instruction 


PUSH IY 
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memory address 1006H will contain 22H, memory address 1005H will contain 
33H, and the Stack Pointer will contain 1005H. The number from register pair 
IY is now on the top of the stack. 


Before: 
Register TY Address Stack 
2233 1007 FF 
1008 35 
Stack Pointer 
1007 


After: PUSH IY 
Register TY Address Stack 


2233 1005 33 
1006 22 
1007 FF 
1008 35 
Stack Pointer 
1005 


POP aq 


Operation: dy (SP + 1), qq, 4(SP) 


Format: 


Mnemonic: POP Operands: qq 
Object Code: 


1 1 qq 0 0 0 1 


Description: 


The top two bytes of the external memory LIFO (last-in, first-out) Stack are 


popped into register pair qq. The Stack Pointer (SP) register pair holds the 16-bit — 


address of the current “‘top’’ of the Stack. This instruction first loads into the 
low order portion of qq, the byte at the memory location corresponding to the 
contents of SP; then SP is incremented and the contents of the corresponding 
adjacent memory location are loaded into the high order portion of qq and the 
SP is now incremented again. The operand qq defines register pair BC, DE, HL, 
or AF, assembled as follows in the object code: 
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Pair r 

BC 00 
DE 01 
HL 10 
AF 11 


M cycles: 3 T states: 10(4,3,3) 4 MHz E.T.: 2.50 
Condition Bits Affected: None 


Example: 


If the Stack Pointer contains 1000H, memory location 1000H contains 55H, and 
location 1001H contains 33H, the instruction 

POP HL 

will result in register pair HL containing 3355H, and the Stack Pointer 
containing 1002H. In other words register pair HL contains the number which 
was on the top of the stack, and the stack pointer is pointing to the current top of 
the stack. 


Before: 
Register HL Address Stack 
2235 1000 55 
1001 33 
1002 A4 
1003 62 
Stack Pointer 
1000 


After: POP HL 
Register HL Address Stack 


3355 1002 A4 
1003 62 
Stack Pointer 
1002 


POP IX 


Operation: IX, (SP + 1), IX_4(SP) 


Format: 
Mnemonic: POP Operands: [X 
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16 BIT LOAD GROUP 


Object Code: 
1 1 0 1 1 1 #0 = 1 DD 
1 1 1 0 0 0 0 = 41 El 
Description: 


The top two bytes of the external memory LIFO (last-in, first-out) Stack are 
popped into Index Register IX. The Stack Pointer (SP) register pair holds the 
16-bit address of the current ‘‘top’’ of the Stack. This instruction first loads into 
the low order portion of [X the byte at the memory location corresponding to the 
contents of SP; then SP is incremented and the contents of the corresponding 
adjacent memory location are loaded into the high order portion of IX. The SP 
is now incremented again. 


M cycles: 4 T states: 14(4,4,3,3) 4 MHz E.T.: 3.50 
Condition Bits Affected: None 


Example: 


If the Stack Pointer contains 1000H, memory location 1000H contains 55H, and 
location 1001H contains 33H, the instruction 
POP IX 


will result in the Index Register [IX containing 3355H, and the Stack Pointer 
containing 1002H. Register pair [X contains the number which used to be on the 
top of the stack. 


Before: 


Register IX Address Stack 


24F9 1000 55 
1001 33 
1002 A4 
1003 62 
Stack Pointer 
1000 


83 











SERIES | EDITOR/ASSEMBLER 
ST 


After: POP IX 
Register IX Address Stack 


3355 1002 A4 
1003 62 
Stack Pointer 
1002 


POP IY 


Operation: IY, (SP + 1),1Y¥, 4 (SP) 


Format: 
Mnemonic: POP Operands: IY 


Object Code: 
1 1 1 1 21 +1 ~=0 = 1 FD 
1 1 1 0 0 0 0 = 1 El 
Description: 


The top two bytes of the external memory LIFO (last-in, first-out) Stack are 
popped into Index Register IY. The Stack Pointer (SP) register pair holds the 
16-bit address of the current ‘‘top’’ of the Stack. This instruction first loads into 
the low order portion of IY the byte at the memory location corresponding to the 
contents of SP; then SP is incremented and the contents of the corresponding 
adjacent memory location are loaded into the high order portion of IY. The SP 
is now incremented again. 


M cycles: 4 T states: 14(4,4,3,3) 4 MHz E.T.: 3.50 
Condition Bits Affected: None 


Example: 

If the Stack Pointer contains 1000H, memory location 1000H contains 55H, and 
location 1001H contains 33H, the instruction 7 
POP IY 


will result in Index Register TY containing 3355H, and the Stack Pointer 
containing 1002H. Register pair [TY contains the number which used to be on the 
top of the stack. 
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Before: 
Register IY Address Stack 
24F9 1000 55 
1001 33 
1002 A4 
1003 62 
Stack Pointer 
1000 


After: POP IY 
Register IY Address Stack 


3355 1002 A4 
1003 62 
Stack Pointer 
1002 
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EXCHANGE, BLOCK TRANSFER AND SEARCH GROUP 


Exchange, Block ‘Transfer 
and Search Group 


EX DE, HL EXchange 


Operation: DE 4) HL 





Format: 


Mnemonic: EX Operands: DE, HL 
Object Code: 


1 1! 1 0 1 0 14 | EB 


Description: 
The two-byte contents of register pairs DE and HL are exchanged. 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 
Condition Bits Affected: None 


Example: 


If the content of register pair DE is the number 2822H, and the content of the 
register pair HL is number 499AH, after the instruction 


EX = DE,HL 


the content of register pair DE will be 499AH and the content of register pair 
HL will be 2822H. 


EX AFAF’ EXchange 


Operation: AF 4) AF’ 


Format: 


Mnemonic: EX Operands: AF, AF’ 
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Object Code: 


0 0 0 0 1 0 0 =O 08 


Description: 


The two-byte contents of the register pairs AF and AF’ are exchanged. 
(Note: register pair AF’ consists of registers A’ and F’) 


M cycles: 1 T states: 4 4 MHz E.T:: 1.00 
Condition Bits Affected: None 


Example: 


If the content of register pair AF is number 9900H, and the content of register 
pair AF’ is number 5944H, after the instruction 


EX AF,AF'’ 
the contents of AF will be 5944H, and the contents of AF will be 9900H. 


EXX EXchange 


Operation: (BC) cp (BC’), (DE) apy (DE’), (HL) a (HL’) 


Format: 


Mnemonic: EXX Operands: 
Object Code: 


I 1 0 1 1 O O 1 D9 


Description: 


Each two-byte value in register pairs BC, DE, and HL is exchanged with the 
two-byte value in BC, DE, and HL, respectively. 


M cycles: 1 T states: 4 4 MHz E.T:: 1.00 
Condition Bits Affected: None 


Example 1: 


If the contents of register pairs BC, DE, and HL are the numbers 445AH, 
3DA2H, and 8859H, respectively, and the contents of register pairs BC; DE, 
and HL’ are 0988H, 9300H, and Q0E7H, respectively, after the instruction 











EXCHANGE, BLOCK TRANSFER AND SEARCH GROUP 


EXX 


the contents of the register pairs will be as follows: BC: 0988H; DE: 9300H; 
HL: 00E7H; BC’: 445AH; DE’: 3DA2H; and HL’: 8859H. 


Example 2: 

If the contents of the registers are as shown: 
BC >: 1111H 

DE > 2222H 

HL : 3333H 

BC’ : 4444H 

DE’ > 5555H 

HL’ : 6666H 

Then after an EXX instruction the registers will contain: 
BC > 4444H 

DE > 5555H 

HL : 6666H 

BC’ : 1111H 

DE’ > 2222H 

HL’ : 3333H 


EX (SP), HL EXchange 


Operation: H Gp (SP + 1), L 4p (SP) 


Format: 
Mnemonic: EX Operands: (SP),HL 


Object Code: 


lt 1 t 0 0 O 1 14] B3 


Description: 


The low order byte contained in register pair HL is exchanged with the contents 
of the memory address specified by the contents of register pair SP (Stack 
Pointer), and the high order byte of HL is exchanged with the next highest 
memory address (SP + 1). 


M cycles: 5 T states: 19(4,3,4,3,5) 4 MHz E.T.: 4.75 


Condition Bits Affected: None 
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Example: 


If the HL register pair contains 7012H, the SP register pair contains 8856H, the 
memory location 8856H contains the byte 11H, and the memory location 8857H 
contains the byte 22H, then the instruction 

EX (SP),HL 

will result in the HL register pair containing number 2211H, memory location 
8856H containing the byte 12H, the memory location 8857H containing the byte 
70H and the Stack Pointer containing 8856H. 


Before: 


Register HL Address Stack 


7012 8856 11 
8857 22 
8858 
Stack Pointer 
8856 
After: 
Register HL Address Stack 
2201 8856 12 
8857 70 
8858 
Stack Pointer 
8856 


- 


EX (S P), IX EXchange 


Operation: IX, 4 (SP + 1), IX, (SP) 


Format: 
Mnemonic: EX Operands: (SP), [xX 


Object Code: 
1 1 0 1 21 21 #0 ~=1 DD 
tf 1 1 0 0 0 1 =1 E3 








EXCHANGE, BLOCK TRANSFER AND SEARCH GROUP 


Description: 


The low order byte in Index Register [X is exchanged with the contents of the 
memory address specified by the contents of register pair SP (Stack Pointer), 
and the high order byte of IX is exchanged with the next highest memory 
address (SP + 1). 


Condition Bits Affected: None 


Example: 


If the Index Register [X contains 3988H, the SP register pair contains 0100H, 
the memory location 0100H contains the byte 90H, and memory location 0101H 
contains byte 48H, then the instruction 


EX (SP),IX 


will result in the [X register pair containing number 4890H, memory location 
0100H containing 88H, memory location 0101H containing 39H and the Stack 
Pointer containing 0100H. 


Before: 


Register IX Address Stack 





3988 0100 90 
| 0101 48 
Stack Pointer 
0100 
After: 
Register IX Address Stack 
4890 0100 88 
0101 39 
Stack Pointer 
0100 


EX (S Py LY EXchange 


Operation: IY, 4 (SP + 1), IY, 4D (SP) 


Format: 


Mnemonic: EX Operands: (SP), IY 





91 











SERIES | EDITOR/ASSEMBLER 


Object Code: 
1 1 1 21 1 21 ~=0 =41 FD 
1 1 1 0 0 0 1 =41 E3 
Description: 


The low order byte in Index Register IY is exchanged with the contents of the 
memory address specified by the contents of register pair SP (Stack Pointer), 
and the high order byte of IY is exchanged with the next highest memory 
address (SP + 1). 


M cycles: 6 T states: 23(4,4,3,4,3,5) 4 MHz E.T.: 5.75 
Condition Bits Affected: None 


Example: 


If the Index Register IY contains 3988H, the SP register pair contains 0100H, 
the memory location 0100H contains the byte 90H, and memory location 
0101H contains byte 48H, then the instruction 


EX (SP),IY 


will result in the IY register pair containing number 4890H, memory location 
Q0100H containing 88H, memory location 0101H containing 39H, and the Stack 
Pointer containing 0100H. 


Before: 


Register IY Address Stack 


3988 0100 90 
0101 48 
Stack Pointer 
0100 
After: 
Register IY Address Stack 
4890 0100 88 
0101 39 
Stack Pointer 
0100 
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LDI LoaD & Increment 
Operation: (DE) 4 (HL), DEGDE + 1, HLO¢HL +1,BC4@BC —1 


Format: 


Mnemonic: LDI Operands: 


Object Code: 


Description: 


A byte of data is transferred from the memory location addressed by the 
contents of the HL register pair to the memory location addressed by the 
contents of the DE register pair. Then both these register pairs are incremented 
and the BC (Byte Counter) register pair is decremented. 


M cycles: 4 T states: 16(4,4,3,5) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


S: Not affected 

Z: Not affected 

H: Reset 

P/V: Set if BC — 1 #9; reset otherwise 
N: Reset 

Cc Not affected 


Example 1: 


If the HL register pair contains 1111H, memory location 1111H contains the byte 
88H, the DE register pair contains 2222H, the memory location 2222H contains 
byte 66H, and the BC register pair contains 7H, then the instruction 

LDI 

will result in the following contents in register pairs and memory addresses: 


HL > = 1112H 
(14i11H) : 88H 


DE : 2223H 
(2222H) : 88H 
BC : 6H 
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and the condition Bits will be: 


| Loti yoy 


S Z H P/V N C 


Example 2: 
If the contents of registers and memory are as shown: 
HL : 7COOH 
(7C00) : FFH 
DE : 3C00H 
(3C00) : OOH 
BC : 1H 
Then after an LDI instruction the registers and memory will contain the 
following: 
HL >: 7CO1H 
(7COO) : FFH 
DE > 3CO1H 
(3C00) : FFH 
BC OH 
and the condition bits will be: 
S Z H P/V N C 
Example 3: 
The following program will move 80 consecutive bytes from BUF1 to BUF2: 
LD HL, BUF1 
LD DE, BUF2 
LD BC, 80 
LOOP LDI 
JP NZ, LOOP 
LDIR LoaD Increment & Repeat 


Operation: (DE) 4(HL), DEQGDE+1, HLGHL+1, BC 4BC — 1 


Format: 


Mnemonic: LDIR Operands: 
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Object Code: 
1 1 1 0 1 21 +0 = 4 ED 
1 Oo 1 1 0 0 0 =0 BO 
Description: 


This two-byte instruction transfers a byte of data from the memory location 
addressed by the contents of the HL register pair to the memory location 
addressed by the DE register pair. Then both these register pairs are incremented 
and the BC (Byte Counter) register pair is decremented. If decrementing causes 
the BC to go to zero, the instruction is terminated. If BC is not zero the program 
counter (PC) is decremented by 2 and the instruction is repeated. Note that if 
BC is set to zero prior to instruction execution, the instruction will loop through 
64K bytes. Also, interrupts will be recognized after each data transfer. 


For BC #90: 

M cycles: 5 T states: 21(4,4,3,5,5) 4 MHz E.T.: 5.25 
For BC=90: 

M cycles: 4 T states: 16(4,4,3,5) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


Not affected 
Not affected 
Reset 
Reset 
Reset 
Not affected 


AAZVINY 
a. 


Example: 


If the HL register pair contains 1111H, the DE register pair contains 2222H, the 
BC register pair contains 0003H, and memory locations have these contents: 


(1111H) : 88H (2222H) : 66H 
(1112H) : 36H (2223H) : 59H 
(1113H) : ASH (2224H) : CSH 
then after the execution of 

LDIR 
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the contents of register pairs and memory locations will be: 


HL > 1114H 
DE > = 2225H 
BC : QQ00H 
(1111H) : 88H (2222H) : 88H 
(1112H) : 36H (2223H) : 36H 
(1113H) : ASH (2224H) : ASH 


and the H, P/V, and N flags are all zero. 


LDD LoaD Decrement 
Operation: (DE) q (HL), DE q DE —1, HL 4 HL—1, BC q BC —-1 


Format: 


Mnemonic: LDD Operands: 


Object Code: 
1 1 1 0 1 21 +0 =41 ED 
1 Oo 1 0 1 0 0 O A8 
Description: 


This two-byte instruction transfers a byte of data from the memory location 
addressed by the contents of the HL register pair to the memory location 
addressed by the contents of the DE register pair. Then both of these register 
pairs, including the BC (Byte Counter) register pair, are decremented. 


M cycles: 4 T states: 16(4,4,3,5) 4 MHz E.T:: 4.00 


Condition Bits Affected: 


S: Not affected 

Z Not affected 

H: Reset 

P/V: Set if BC — 1#0; reset otherwise 
N: Reset 

Cc Not affected 
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Example 1: 


If the HL register pair contains 1111H, memory location 1111H contains the byte 
88H, the DE register pair contains 2222H, memory location 2222H contains 
byte 66H, and the BC register pair contains 7H, then the instruction 


LDD 

will result in the following contents in register pairs and memory addresses: 
HL >: 1110H 

(1111H) : 88H 

DE : = 2221H 

(2222H) : 88H 

BC : 6H 


and the condition bits will be: 


S Z H P/V 
Example 2: 
If the contents of registers and memory are as shown: 
HL : 7CFFH 
(7CFF) : 3CH 
DE : 3CFFH 
(3CFF) : QOH 
BC : 1H 
Then after a LDD instruction the registers and memory will contain the 
following: 
HL : 7CFEH 
(7JCFF) : 3CH 
DE : 3CFEH 
(3CFF) : 3CH 
BC : OH 


and the condition bits will be: 


S Z H P/V 


LDDR LoaD Decrement & Repeat 
Operation: (DE) 4(HL), DE@DE — 1, HLG¢HL— 1, BO@BC — 1 


Format: 
Mnemonic: LDDR Operands: 
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Object Code: 
1 | t O 1 1 O 1 ED 
1 oOo 1 1 +1 +0 0 +0 B8 
Description: 


This two-byte instruction transfers a byte of data from the memory location 
addressed by the contents of the HL register pair to the memory location 
addressed by the contents of the DE register pair. Then both of these registers 
as well as the BC (Byte Counter) are decremented. If decrementing causes the 
BC to go to zero, the instruction is terminated. If BC is not zero, the program 
counter (PC) is decremented by 2 and the instruction is repeated. Note that if 
BC is set to zero prior to instruction execution, the instruction will loop through 
64K bytes. Also, interrupts will be recognized after each data transfer. 


For BC #90: 

M cycles: 5 T states: 21(4,4,3,5,5) 4 MHz E.T.: 5.25 
For BC =9: 

M cycles: 4 T states: 16(4,4,3,5) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


Not affected 
Not affected 
Reset 
Reset 
Reset 
Not affected 


O22? 
a 


Example: 


If the HL register pair contains 1114H, the DE register pair contains 2225H, the 
BC register pair contains 0003H, and memory locations have these contents: 


(1114H) : ASH (2225H) : CSH 
(1113H) : 36H (2224H) : 59H 
(1112H) : 88H (2223H) : 66H 
then after the execution of 

LDDR 





PS Ea Pat 
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the contents of register pairs and memory locations will be: 


HL > J111H 
DE -, 2222 
BC : @Q000H 
(1114H) : ASH (2225H) : ASH 
(1113H) : 36H (2224H) : 36H 
(1112H) : 88H (2223H) : 88H 


and the H, P/V, and N flags are all zero. 


CPI ComPare & Increment 
Operation: A — (HL), HLGHL+ 1, BC 4BC — 1 


Format: 


Mnemonic: CPI Operands: 


Object Code: 
1 1 1 0 1 1 +0 =41 ED 
ll O 1 0 0 0 0 1 Al 
Description: 


The contents of the memory location addressed by the HL register pair is 
compared with the contents of the Accumulator. In case of a true compare, the 
Z condition bit is set. Then HL is incremented and the Byte Counter (register 
pair BC) is decremented. 


M cycles: 4 T states: 16(4,4,3,5) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
LZ. Set if A= (HL); reset otherwise 

H: Set if borrow from Bit 4; reset otherwise 
P/V: Reset if BC becomes Q; set otherwise © 
N: Set 

C: Not affected 
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Example: 


If the HL register pair contains 1111H, memory location 1111H contains 3BH, 
the Accumulator contains 3BH, and the Byte Counter contains 0001H, then after 
the execution of 


CPI 
the Byte Counter will contain 0QQ0H, the HL register pair will contain 1112H, 


the Z flag in the F register will be set, and the P/V flag in the F register will be 
reset. There will be no effect on the contents of the Accumulator or address 


1111H. 

If the contents of memory and registers are as shown 
HL : 8AQ0H 

(8AQ0H) : 6DH 

A : 75H 

BC >: 5H 


Then during the execution of a CPI instruction the Arithmetic and Logic Unit 
will do the following subtraction: 


Borrow needed here 
oD 


75H = 0111 0101 
— 6DH = 0110 1101 


8H = 0000 1000 
After CPI is executed registers and memory will contain the following: 





HL : 8AQI1H 
(8AQ00H) : 6DH 

A : 75H 
BC : 4H 


and the condition bits would be: 


O,o;ififi|t 


S Z H PVN C 


result positive om 2 2 2 2 oa not affected 
match not found always set 
borrow from bit 4 BC not zero 
Example 3: 


The following program is used to verify that the contents of two 80-byte buffers 
are identical. Each time a mismatch is found the program calls a subroutine 
called ERROR. 
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STRT LD HL, BUF1 
LD DE, BUF2 
LD BC, 80 
LOOP LD A, (DE) 
CPI 
CALL NZ,ERROR 
INC DE 
JR PO, LOOP 
END 
CPI R ComPare Increment & Repeat 


Operation: A — (HL), HL¢HL+1, BO4BC — 1 


Format: 


Mnemonic: CPIR Operands: 


Object Code: 
Ll 1 1 0 1 21 0 ~=1 ED 
1 oO 1 1 0 0 0 = 1 Bl 
Description: 


The contents of the memory location addressed by the HL register pair is 
compared with the contents of the Accumulator. In case of a true compare, the 
Z condition bit is set. The HL is incremented and the Byte Counter (register 

pair BC) is decremented. If decrementing causes the BC to go to zero or if 

A= (HL), the instruction is terminated. If BC is not zero and A#(HL), the 
program counter is decremented by 2 and the instruction is repeated. Note that if 
BC is set to zero before the execution, the instruction will loop through 64K 
bytes, if no match is found. Also, interrupts will be recognized after each data 
comparison. 


For BC #@ and A# (HL): 

M cycles: 5 T states: 21(4,4,3,5,5) 4 MHz E.T.: 5.25 
For BC #90 or A=(HL): 

M cycles: 4 T states: 16(4,4,3,5) 4 MHz E.T.: 4.00 
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Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Zz Set if A=(HL); reset otherwise 

H: Set if borrow from Bit 4; reset otherwise 
P/V: Reset if BC becomes Q; set otherwise 

N: Set 

C: Not affected 

Example: 


If the HL register pair contains 1111H, the Accumulator (Register A) contains 
F3H, the Byte Counter contains 0007H, and memory locations have these 
contents: 


(1i11H) : 52H 

(1112H) : QOH 

(1113H) : F3H 

then after the execution of 

CPIR 

the contents of register pair HL will be 1114H, and the contents of the Byte 
Counter will be 0004H. Since BC #9, the P/V flag is still set. This means that it 
did not search through the whole block before the instruction stopped. Since a 
match was found, the Z flag is set. 


The following program uses the CPIR instruction to count the number of nulls 
(00H) found in an 80-byte buffer. The count is kept in register E. 


STRT LD BC, 80 
LD HL, BUFF 
LD A,0 
LD E, 0 
LOOP CPIR 
JR NZ, FOO 
INC E 
FOO JP PE, LOOP 
END 
CPD ComPare & Decrement 


Operation: A- (HL), HL 4 HL — 1, BC 4 BC —1 


Format: 


Mnemonic: CPD Operands: 
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Object Code: 
1 1 1 0 1 1 +0 = 41 ED 
i o 1 0 1 0 0 41 A9 
Description: 


The contents of the memory location addressed by the HL register pair is 
compared with the contents of the Accumulator. In case of a true compare, the Z 
condition bit is set. The HL and the Byte Counter (register pair BC) are 
decremented. 


M cycles: 4 T states: 16(4,4,3,5) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


Set if result is negative; reset otherwise 
Set if A=(HL); reset otherwise 

Set if borrow from Bit 4; reset otherwise 
Reset if BC becomes zero; set otherwise 
Set 

Not affected 


QAZUTANY 
a5 


Example: 


If the HL register pair contains 1111H, memory location 1111H contains 3BH, 
the Accumulator contains 3BH, and the Byte Counter contains 0001H, then after 
the execution of 


CPD 


the Byte Counter will contain QOQQH, the HL register pair will contain 1110H, 
the Z flag in the F register will be set and the P/V flag in the F register will be 
reset. There will be no effect on the contents of the Accumulator or address 
1111H. 


Since the CPD instruction decrements HL, it is used to search through memory 
from high to low addresses. Otherwise it is similar to the CPI instruction. 





CP DR ComPare Decrement & Repeat 
Operation: A — (HL), HLG€HL— 1, BC GBC — 1 


Format: 


Mnemonic: CPDR Operands: 
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Object Code: 
1 1 1 0 1 21 0 = 41 ED 
1 oO 1 1 1 0 0 1 B9 
Description: 


The contents of the memory location addressed by the HL register pair is 
compared with the contents of the Accumulator. In case of a true compare, the 
Z condition bit is set. The HL and BC (Byte Counter) register pairs are 
decremented. If decrementing causes the BC to go to zero or if A=(HL), the 
instruction is terminated. If BC is not zero and A#(HL), the program counter is 
decremented by 2 and the instruction is repeated. Note that if BC is set to zero 
prior to instruction execution, the instruction will loop through 64K bytes, if no 
match is found. Also, interrupts will be recognized after each data comparison. 


For BC #0 and A#(HL): 

M cycles: 5 T states: 21(4,4,3,5,5) 4 MHz E.T.: 5.25 
For BC = @ or A = (HL): 

M cycles: 4 T states: 16(4,4,3,5) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Zz. Set if A= (HL), reset otherwise 

H: Set if borrow from Bit 4; reset otherwise 
P/V Reset if BC becomes zero; set otherwise 
N: Set 

Cc Not affected 

Example: 


If the HL register pair contains 1118H, the Accumulator contains F3H, the Byte 
Counter contains 0003H, and memory locations have these contents: 


(1118H) : 52H 
(1117H) : QOH 
(1116H) : F3H 

then after the execution of 
CPDR 


the contents of register pair HL will be 1115H, the contents of the Byte Counter 
will be 00Q0H, the P/V flag in the F register will be reset, and the Z flag in the 
F register will be set. 
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8 BIT ARITHMETIC AND LOGICAL GROUP 


8 Bit Arithmetic and Logical Group 
ADD A,r 


Operation: AGA +r 


Format: 


Mnemonic: ADD Operands: A, r 
Object Code: 


1 0 O O O fr rr rr 


Description: 


The contents of register r are added to the contents of the Accumulator, and the 
result is stored in the Accumulator. The symbol r identifies the registers A, B, 
C, D, E, H or L assembled as follows in the object code: 


Register r 
A = 111 
B = 000 
C = 001 
D =~ 010 
E = 011 
H = 100 
L = 101 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 


Condition Bits Affected: 





S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Set if carry from Bit 3; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Reset 

C: Set if carry from Bit 7; reset otherwise 
Example: 


If the contents of the Accumulator are 44H, and the contents of register C are 
11H, after the execution of 


ADD A,C 
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the contents of the Accumulator will be 55H. See Appendix K for more details 
of condition bits affected. 


ADD A,n 


Operation: AGA+Nn 


Format: 


Mnemonic: ADD Operands: A, n 
Object Code: 


1 1 0 0 0 1 =#1 =90 C6 


Description: 


The integer n is added to the contents of the Accumulator and the results are 
stored in the Accumulator. 


M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
ZL Set if result is zero; reset otherwise 

H: Set if carry from Bit 3; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Reset 

C: Set if carry from Bit 7; reset otherwise 
Example: 


If the contents of the Accumulator are 23H, after the execution of 
ADD A,33H 


the contents of the Accumulator will be 56H. 
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ADD A,(HL) 


Operation: AQ A+ (HL) 


Format: 
Mnemonic: ADD —— Operands: A, (HL) 


Object Code: 


ll 0 0 0 0 1 1 =O 86 


Description: 


The byte at the memory address specified by the contents of the HL register 
pair is added to the contents of the Accumulator and the result is stored in the 
Accumulator. 


M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Set if carry from Bit 3; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Reset 

c Set if carry from Bit 7; reset otherwise 
Example: 


If the contents of the Accumulator are AQH, and the content of the register 
pair HL is 2323H, and memory location 2323H contains byte 08H, after the 
execution of 


ADD A,(HL) 
the Accumulator will contain A8H. 


ADD A,(IX+d) 
Operation: AGA + (IX+d) 


Format: 


Mnemonic: ADD Operands: A, (IX+ d) 
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Object Code: 


DD 


! 0 0 0 0 1 86 


d dddddqdéq4d 


es 
rea 
S 
— 
as 
3 
_ oO 
Oo _ 


Description: 


The contents of the Index Register (register pair IX) is added to a two’s 
complement displacement d to point to an address in memory. The contents of 
this address is then added to the contents of the Accumulator and the result is 
stored in the Accumulator. 


M cycles: 5 T states: 19(4,4,3,5,3) 4 MHz E.T.: 4.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Set if carry from Bit 3; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Reset 

@ Set if carry from Bit 7; reset otherwise 
Example: 


If the Accumulator contents are 11H, the Index Register [X contains 1000H, and 
if the content of memory location 1005H is 22H, after the execution of 


ADD A,(IX+ 5H) 
the contents of the Accumulator will be 33H. 


ADD A,(IY+d) 


Operation: AG A+ (1Y +d) 


Format: 


Mnemonic: ADD Operands: A, ([Y+d) 
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8 BIT ARITHMETIC AND LOGICAL GROUP 


Object Code: 
1 1 1 21 #71 ~=21 ~=0 = 1 FD 
ll 0 0 0 0 1 +1 =O 86 


d ddd ddqdéiq4d 


Description: 


The contents of the Index Register (register pair IY) is added to the 
displacement d to point to an address in memory. The contents of this address 
is then added to the contents of the Accumulator and the result is stored in the 
Accumulator. 


M cycles: 5 T states: 19(4,4,3,5,3) 4 MHz E.T.: 4.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Set if carry from Bit 3; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Reset 

C: Set if carry from Bit 7; reset otherwise 
Example: 


If the Accumulator contents are 11H, the Index Register pair TY contains 1000H, 
and if the content of memory location 1005H is 22H, after the execution of 


ADD A,(TY+5H) 
the contents of the Accumulator will be 33H. 


ADC A,S ADd with Carry 


Operation: AGA+S+ CY 





Format: 
Mnemonic: ADC Operands: A, s 


The s operand is any of r, n, (HL), (IX+d) or ([Y+d) as defined for the 
analogous ADD instruction. These various possible opcode-operand 
combinations are assembled as follows in the object code: 
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Object Code: 

ADC A,r 1000i1rr ri 

ADC A, n 1 10011 1 «0 CE 
n n n n n n n n 

ADCA,(IX+d) |1 1 01 1 1 01 DD 
100011 1 «0 8E 

ADCA,(IY+d) |1 1 1 1 1°10 1 FD 


1 0 0 0 1 1 +21 =O 8E 


d ddddddéeq#4d 


r identifies registers A, B, C, D, E, H, or L assembled as follows in the object 
code field above: 


Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 

Description: 


The s operand, along with the Carry Flag (“*C’’ in the F register) is added to the 
contents of the Accumulator, and the result is stored in the Accumulator. 
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M 4 MHz 
Instruction Cycles T States E.T. in ws 
ADC A,r l 4 1.00 
ADC A, n 2 7(4,3) 1.75 
ADC A, (HL) 2 7(4,3) 1.75 
ADC A, ([X+ d) 5 19(4,4,3,5,3) 4.75 
ADC A, (IY+d) 5 19(4,4,3,5,3) 4.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
ZL Set if result is zero; reset otherwise 

H: Set if carry from Bit 3; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Reset 

C: Set if carry from Bit 7; reset otherwise 


Example 1: 


If the Carry Flag is set, the Accumulator contains 16H, the HL register pair 
contains 6666H, and address 6666H contains 10H, after the execution of 


ADC A, (HL) 
the Accumulator will contain 27H. 


Example 2: 


If the Carry Flag is set, the Accumulator contains 30H, and register C contains 0 
5H, then after the execution of 


ADC A, C 
the Accumulator will contain 36H. 


SUB s SUBtract 


Operation: AGA —S 


Format: 
Mnemonic: SUB Operands: s 


The s operand is any of r, n, (HL), (IX+d) or ([Y+d) as defined for the 
analogous ADD instruction. These various possible opcode-operand 
combinations are assembled as follows in the object code: 
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Object Code: 
SUB r 1 0 O 1 0O fr sr sr 
SUB n 1 1 0 1 0 1 +1 ~=«0 D6 


SUB (HL) 1 0 0 1 0 21 1 =0 96 


SUB (IX+ d) 1 1 0 1 1 1 0 141 DD 


1 0 0 1 0 1 +1 ~=90 96 


SUB (IY+d) 1 1 1 1 71 1 #0 =41 FD 
1 0 O 1 O 1 1 =O 96 


d dddddqdéq4d 


r identifies registers A, B, C, D, E, H or L assembled as follows in the object 
code field above: 


Register r 
A = 111 
B = 000 
C = 001 
D =~ 0610 
E = 011 
H = 100 
L = 101 

Description: 


The s operand is subtracted from the contents of the Accumulator, and the result 
is stored in the Accumulator. 
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M 4 MHz 
Instruction Cycles T States E.T. in ws 
SUB r 1 4 1.00 
SUB n 2 7(4,3) 1.75 
SUB (HL) 2 7(4,3) 1.75 
SUB (IX+d) 5 19(4,4,3,5,3) 4.75 
SUB (IY+d) 5 19(4,4,3,5,3) 4.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Zz Set if result 1s zero; reset otherwise 

H: Set if borrow from Bit 4; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Set 

C: Set if borrow; reset otherwise 

Example: 


If the Accumulator contains 29H and register D contains 11H, after the 
execution of 


SUB D 
the Accumulator will contain 18H. 


SBC A,s: SuBtract with borrow (Carry) 
Operation: ACG A— s — CY 


Format: 
Mnemonic: SBC Operands: A, s 


The s operand is any of r, n, (HL), ([X+d) or (IY+d) as defined for the 
analogous ADD instructions. These various possible opcode-operand 
combinations are assembled as follows in the object code: 


Object Code: 


SBC A,r 


SBC A, n DE 


—a — 
— © 
© © | 
— pet 
— pend 
— m 
— mt 

cS =} 
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SBC A, (HL) 100411 1 1 #0 OE 
SBC A, (IX+d) 110141 1 0 41 DD 
10041 1 41 1 «0 OF 


d ddddddéqd 


SBC A,(LY +d) 1 1 1 1 1 #1 +0 = 121 FD 


9E 


d ddd dd déq4d 


— 
© 
© 
— 
— 
—_ 
eek 
© 


r identifies registers A, B, C, D, E, H, or L assembled as follows in the object 
code field above: 


Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
i. = 101 

Description: 


The s operand, along with the Carry Flag (‘*C’’ in the F register) is subtracted 
from the contents of the Accumulator, and the result is stored in the 
Accumulator. 
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M 4 MHz 
Instruction Cycles T States E.T. in ws 
SBC A,r 1 4 1.00 
SBC A, n 2 7(4,3) 1.75 
SBC A, (HL) 2 7(4,3) 1.75 
SBC A, (IX+d) 5 19(4,4,3,5,3) 4.75 
SBC A, (ITY+d) 5 19(4,4,3,5,3) 4.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Set if borrow from Bit 4; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Set 

Cc; Set if borrow; reset otherwise 

Example 1: 


If the Carry Flag is set, the Accumulator contains 16H, the HL register pair 
contains 3433H, and address 3433H contains 05H, after the execution of 


SBC A,(HL) 
the Accumulator will contain 10H. 


Example 2: 


If the Carry Flag is set, the Accumulator contains 21H and register B contains Q, 
then after the execution of 


SBC A,B 
the Accumulator contains 20H. 


AND s 


Operation: AGA Ss 


Format: 
Mnemonic: AND Operands: s 


The s operand is any of r, n, (HL), (IX+d) or ([Y+d), as defined for the 
analogous ADD instructions. These various possible opcode-operand 
combinations are assembled as follows in the object code: 
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Object Code: 


ANDr 1 O 1 0 0 r sr or 


AND n ll 1 1 0 O0O 1 1 =O E6 


AND (HL) 1 O 1 0 0 1 #1 =O A6 
AND ([X+ d) 1 1 0 1 1 +21 +0 ~=21 DD 
1 0 1 0 0 1 +1 =«0 A6 


ddddddqdéq4d 


AND (lY+d) 1 1 21 1 1 #1 +0 ~=4 FD 


1 O 1 0 0 1 +1 =O A6 


d ddddddéqqd 


r identifies register A, B, C, D, E, H or L assembled as follows in the object 
code field above: 


Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 
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8 BIT ARITHMETIC AND LOGICAL GROUP 


Description: 


A logical AND operation, Bit by Bit, is performed between the byte specified 
by the s operand and the byte contained in the Accumulator; the result is stored 
in the Accumulator. 


M 4 MHz 
Instruction Cycles T States E.T. in ws 
AND r 1 4 1.00 
AND n 2 7(4,3) 1.75 
AND (HL) 2 7(4,3) 1.75 
AND (IX+d) 5 19(4,4,3,5,3) 4.75 
AND (IX +d) 5 19(4,4,3,5,3) 4.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 
H: Set 
P/V: Set if parity even; reset otherwise 
N: Reset 
C Reset 
Table of AND Values: 
IF Then 

A B A (After) 

0 0 0 

0 1 0 

I 0 0 

1 I 1 
Example: 


If the B register contains 7BH (@1111011) and the Accumulator contains C3H 
(11000011), after the execution of 


AND B 
the Accumulator will contain 43H (01000011). 


OR s 


Operation: AGA CS 


Format: 


Mnemonic: OR Operands: s 
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The s operand is any of r, n, (HL), (IX+d), or (IY+d), as defined for the 
analogous ADD instructions. These various possible opcode-operand 
combinations are assembled as follows in the object code: 


Object Code: 

OR n 1 1 1 1 0 1 +1 ~=0 F6 

OR (HL) 1 0 1 1 0 1 1 =0 B6 
1 0 1 1 0 1 +21 ~=«~0 B6 

OR (IY+d) 1 1 1 21 #21 ~=21 ~=0~=«1 FD 
1 O 1 1 0 1 +1 =O B6 


d dddddqdéeqqd 


r identifies register A, B, C, D, E, H or L assembled as follows in the object 
code field above: 


Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 
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8 BIT ARITHMETIC AND LOGICAL GROUP 


Description: 


A logical OR operation, Bit by Bit, is performed between the byte specified by 
the s operand and the byte contained in the Accumulator; the result is stored in 
the Accumulator. 


M 4 MHz 
Instruction Cycles T States E.T. in ws 
OR r 1 4 1.00 
OR n 2 7(4,3) 1.75 
OR (HL) 2 7(4,3) 1.75 
OR (IX+d) 5 19(4,4,3,5,3) 4.75 
OR (IY+d) 5 19(4,4,3,5,3) 4.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Zz: Set if result is zero; reset otherwise 
H: Reset 
P/V: Set if parity even; reset otherwise 
N: Reset 
Cc: Reset 
Table of OR Values: 
IF Then 

A B A (After) 

0 0 0 

0 l l 

l 0 l 

l 1 1 
Example: 


If the H register contains 48H (91001000) and the Accumulator contains 
12H (00010010), after the execution of 


OR H 
the Accumulator will contain SAH (01011010). 


XOR s eXclusive OR 
Operation: AQ A®s 


Format: 


Mnemonic: XOR Operands: s 
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The s operand is any of r, n, (HL), ([IX+d) or ([Y+d), as defined for the 
analogous ADD instructions. These various possible opcode-operand 
combinations are assembled as follows in the object code: 


Object Code: 

XOR n 1 1 1 0 1 1 ~=«21 ~=«0 EE 
nnn ononon ono 

XOR (HL) 1 0 1 0 1 +1 =1 ~=«0 AE 
1 0 1 0 1 1 #21 ~=«0 AE 

XOR (IY+ d) 1 1 1 21 =21~=21 ~=~0~=1 FD 
1 0 1 0 1 +21 ~=«21 ~=«~90 AE 


d ddddddéi£ 44d 


r identifies registers A, B, C, D, E, H or L assembled as follows in the object 
code field above: 


Register r 
A = 111 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 
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8 BIT ARITHMETIC AND LOGICAL GROUP 


Description: 


A logical exclusive-OR operation, bit by bit, is performed between the byte 
specified by the s operand and the byte contained in the Accumulator; the result 
is stored in the Accumulator. 


M 4 MHz 
Instruction Cycles T States E.T. in ps 
XOR r 1 4 1.00 
XOR n 2 7(4,3) 1.75 
XOR (HL) 2 7(4,3) 1.75 
XOR (IX+ d) 5 19(4,4,3,5,3) 4.75 
XOR (IY+ d) 5 19(4,4,3,5,3) 4.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 
H: Reset 
P/V: Set if parity even; reset otherwise 
N: Reset 
C: Reset 
Table of XOR Values: 
IF Then 

A B A (After) 

0 0 0 

0 ] l 

] 0 1 

1 1 0 


Note: in Table above that any two like numbers will result in zero. 


Example 1: 


If the Accumulator contains 96H (10010110), after the execution of 
XOR 5DH_ (Note: 5SDH=01011101) 
the Accumulator will contain CBH (11001011). 


Example 2: 


The instruction 
XOR A 
will zero the Accumulator. 
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CPs ComPare 


Operation: A-s 


Format: 
Mnemonic: CP Operands: s 


The s operand is any of r, n, (HL), (IX+d) or ([Y+d), as defined for the 
analogous ADD instructions. These various possible opcode-operand 
combinations are assembled as follows in the object code: 


Object Code: 
CPr 1 0 41 41 41 ér r ir 
CP n Lt be tit. dt. &.8 FE 


CP (HL) 1 O i 1 1 +21 1 =0 BE 


CP ([X+ d) 1 1 0 1 1 21 0 41 DD 
1 O 1 1 +21 =21 ~=21 ~=«~0 BE 
CP (TY + d) 1 1 21 1 +21 421 0 41 FD 
1 O 1 1 21 +21 ~=21 ~=0 BE 


d dddddqdéqd 


r identifies register A, B, C, D, E, H or L assembled as follows in the object 
code field above: 


122 











8 BIT ARITHMETIC AND LOGICAL GROUP 
SN I IE 


Register r 
A = 111 
B = 000 
Cc = 001 
D = 010 
E = 011 
H = 100 
L = 101 

Description: 


The contents of the s operand are compared with the contents of the » 
Accumulator. If there is a true compare, a flag 1s set. 


M 4 MHz 
Instruction Cycles T States E.T. in ws 
CP r 1 4 1.00 
CP n 2 7(4,3) 1.75 
CP (HL) 2 7(4,3) 1.75 
CP (IX+ d) 5 19(4,4,3,5,3) 4.75 
CP (ITY+d) 5 19(4,4,3,5,3) 4.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
ZL: Set if result is zero; reset otherwise 

H: Set if borrow from Bit 4; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Set 

c Set if borrow in Bit 7; reset otherwise 


Example 1: 


If the Accumulator contains 63H, the HL register pair contains 6000H and 
memory location 60Q00H contains 60H, the instruction 

CP (HL) 

will result in all the flags being reset except N. 


Example: 2 


If the Accumulator contains 65H and register C also contains 65H, then after the 
execution of 

CP C 

the Z flag will be set. 

See Appendix E for more details of condition codes affected. 
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INC r INCrement 


Operation: fdr + 1 


Format: 


Mnemonic: INC Operands: r 
Object Code: 


0 O r r r 1 0 O 


Description: 


Register r is incremented. r identifies any of the registers A, B, C, D, E, H or 
L, assembled as follows in the object code. 


Register r 
A = 111 
B = 000 
C =~ 001 
D =~ 06010 
E = Oil 
H = 100 
L = 101 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 

Z: Set if result is zero; reset otherwise 

H: Set if carry from Bit 3; reset otherwise 

P/V: Set if r was 7FH before operation; reset otherwise 
N: Reset 

c: Not affected 

Example: 


If the contents of register D are 28H, after the execution of 
INC D 
the contents of register D will be 29H. 
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INC (A L) INCrement 


Operation: (HL) G(HL) + 1 


Format: 


Mnemonic: INC Operands: (HL) 
Object Code: 


0 0 1 1 0 1 +0 +0 34 


Description: 


The byte contained in the address specified by the contents of the HL register 
pair is incremented. 


M cycles: 3 T states: 11(4,4,3) 4 MHz E.T:: 2.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 

Zz: Set if result 1s zero; reset otherwise 

H: Set if carry from Bit 3; reset otherwise 

P/V: Set if (HL) was 7FH before operation; reset otherwise 
N: Reset 

C: Not Affected 

Example: 


If the contents of the HL register pair are 3434H, and the contents of address 
3434H are 82H, after the execution of 


INC (HL) 
memory location 3434H will contain 83H. 


INC (IX+ d) INCrement 


Operation: (IX+ d) 4 (IX+ d) + 1 


Format: 


Mnemonic: INC Operands: (IX+ d) 
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Object Code: 


1 | O 1 1 1 0 1 DD 


0 0 1 1 0 1 +0 =0 34 


ladda aad a 


Description: 


The contents of the Index Register IX (register pair IX) are added to a two’s 
complement displacement integer d to point to an address in memory. The 
contents of this address are then incremented. 


M cycles: 6 T states: 23(4,4,3,5,4,3) 4 MHz E.T.: 5.75 


Condition Bits Affected: 


Set if result is negative; reset otherwise 

Set if result is zero; reset otherwise 

Set if carry from Bit 3; reset otherwise 

Set if ([IX+d) was 7FH before operation; reset otherwise 
Reset 

Not affected 


Q2Z7UGNY 
meee 


Example: 


If the contents of the Index Register pair IX are 2020H, and the memory 
location 2030H contains byte 34H, after the execution of 


INC (IX+ 10H) 
the contents of memory location 2030H will be 35H. 


INC (IY ae d) INCrement 


Operation: (IY + d) G(IY +d) + 1 


Format: 


Mnemonic: INC Operands: (IY + d) 
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8 BIT ARITHMETIC AND LOGICAL GROUP 


Object Code: 


d dddddqdéq4d 


Description: 


The contents of the Index Register IY (register pair [Y) are added to a two’s 
complement displacement integer d to point to an address in memory. The 
contents of this address are then incremented. 


M cycles: 6 T states: 23(4,4,3,5,4,3) 4 MHz E.T.: 5.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 

V bp Set if result is zero; reset otherwise 

H: Set if carry from Bit 3; reset otherwise 

P/V: Set if ([Y+d) was 7FH before operation; reset otherwise 
N: Reset 

C: Not Affected 

Example: 


If the contents of the Index Register pair TY are 2020H, and the memory 
location 2030H contain byte 34H, after the execution of 


INC (I1Y+ 10H) 
the contents of memory location 2030H will be 35H. 


DEC m DECrement 


Operation: MQM — 1 


Format: 
Mnemonic: DEC Operands: m 


The m operand is any of r, (HL), (IX+d) or ([Y+d), as defined for the 
analogous INC instructions. These various possible opcode-operand 
combinations are assembled as follows in the object code: 
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Object Code: 

DEC r O 0 r r r 1 0 1 

DEC (HL) 0 0 1 1 0 1 0 41 35 

DEC (IX+ d) 1 1 0 1 1 21 ~=0 = 41 DD 
0 0 1 1 0 1 0 = 1 35 
0 0 1 1 0 1 0 = 41 35 


r identifies register A, B, C, D, E, H or L assembled as follows in the object 
code field above: 


Register r 
A = 11] 
B = 000 
C = 001 
D = 010 
E = 011 
H = 100 
L = 101 

Description: 


The byte specified by the m operand is decremented. 
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M 4 MHz 
Instruction Cycles T States E.T. in ws 
DEC r 1 4 1.00 
DEC (HL) 3 11(4,4,3) 2.75 
DEC (IX+ d) 6 23(4,4,3,5,4,3) 5.75 
DEC (IY +d) 6 23(4,4,3,5,4,3) 5.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 

Z: Set if result is zero; reset otherwise 

H: Set if borrow from Bit 4; reset otherwise 

P/V: Set if m was 80H before operation; reset otherwise 
N: Set 

C: Not affected 

Example: 


If the D register contains byte 2AH, after the execution of 
DEC D 
register D will contain 29H. 
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General Purpose Arithmetic and 
CPU Control Groups 


DAA 


Operation: Decimal-Adjust Accumulator 


Format: 
Mnemonic: DAA Operands: 


Object Code: 


0 0 1 0 0 1 1 ~=«1 


Description: 


This instruction modifies the results of addition or subtraction so that the results 
of binary arithmetic are correct for decimal numbers. The Binary Coded 
Decimal (BCD) code uses the 8-bit accumulator as follows: the eight bits are 
broken up into two groups of four bits, which represent a two-digit decimal 
number from 00 to 99. If numbers like this are added with the binary adder in 
the Z-80, answers larger than 10 may result in each decimal place. The DAA 
instruction will ‘‘adjust’’ the answer so that each decimal place has a value of 9 
or less, and so that the digits have the correct decimal value, though they were 
added by a binary circuit. The carry and half-carry flags are used in this 
conversion, as is a circuit that detects digits that are 10 or bigger. 


HEX HEX 
Value in Valuein = Number | 

C Upper H Lower Added C 

Before Digit Before Digit to After 

Operation DAA (bits 7-4) DAA (bits 3-0) Byte DAA 
0 0-9 0 0-9 00 0 
0 0-8 0 A-F 06 0 
0 0-9 ] 0-3 06 0 
ADD 0 A-F 0 0-9 60 1 
ADC 0 9-F 0 A-F 66 ] 
INC 0 A-F 1 0-3 66 1 
1 0-2 0 0-9 60 1 
1 Q-2 0 A-F 66 1 
1 0-3 1 0-3 66 1 
SUB 0 0-9 0 0-9 00 0 
SBC 0 0-8 1 6-F FA 0 
DEC 1 7-F 0 0-9 AO 1 
NEG 1 6-F 1 6-F 9A 1 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 
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Condition Bits Affected: 


S: Set if most significant bit of Acc. is 1 after operation; reset otherwise 
Z: Set if Acc. is zero after operation; reset otherwise 

H: See instruction 

P/V: Set if Acc. is even parity after operation; reset otherwise 

N: Not affected 

Ge See instruction 


Example: 


If an addition operation is performed between 15 (BCD) and 27 (BCD), simple 
decimal arithmetic gives this result: 


I5 
2 


42 


But when the binary representations are added in the Accumulator according to 
standard binary arithmetic, 


0001 0101 
+0010 0111 


0011 1100=3C 


the sum is not decimal. The DAA instruction adjusts this result so that the 
correct BCD representation is obtained: 


0011 1100 
+0000 0110 (adding 06 from table) 


0100 0010=42 


CPL ComPLement 


Operation: A 4 A 


Format: 


Mnemonic: CPL Operands: 
Object Code: 


0 0 1 0 1 21 +21 ~=+T4t  2F 











GENERAL PURPOSE ARITHMETIC AND CPU CONTROL GROUPS 


Description: 
Contents of the Accumulator (register A) are inverted (one’s complement). 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 


Condition Bits Affected: 


S: Not affected 
Zz Not affected 
H: Set 

P/V: Not affected 
N: Set 

C: Not affected 
Example: 


If the contents of the Accumulator are 1011 0100, after the execution of 
CPL 
the Accumulator contents will be 0100 1011. 


NEG NEGate 


Operation: AGO —A 


Format: 


Mnemonic: NEG Operands: 


Object Code: 
1 1 1 0 1 1 0 =1 ED 
0 1 0 0 0 1 0 +0 44 
Description: 


Contents of the Accumulator are negated (two’s complement). This is the same 
as subtracting the contents of the Accumulator from zero. Note that 80H is left 
unchanged. 


M cycles: 2 T states: 8(4,4) 4 MHz E.T.: 2.00 


133 





SERIES | EDITOR/ASSEMBLER 


Condition Bits Affected: 


5: Set if result is negative; reset otherwise 

Z: Set if result is zero; reset otherwise 

H: Set if borrow from Bit 4; reset otherwise 

P/V: Set if Acc. was 80H before operation; reset otherwise 

N: Set 

C. Set if Acc. was not 00H before operation; reset otherwise 
Example: 


If the contents of the Accumulator are 
Fi fofotift if ofolo 


after the execution of 
NEG 
the Accumulator contents will be 


Ee 0 FO) a0: 20.0 | 


CCF Complement Carry Flag 
Operation: CYACY 


Format: 


Mnemonic: CCF Operands: 
Object Code: 


O O 1 1 1 1 I I{  3F 


Description: 
The C flag in the F register is inverted. 
M cycles: 1 T states: 4 4 MHz E.T.: 1.00 


Condition Bits Affected: 


S: Not affected 

Z: Not affected 

H: Previous carry will be copied 

P/V: Not affected 

N: Reset 

C: Set if CY was 0 before operation; reset otherwise | 
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SCF Set Carry Flag 


Operation: CY 4 1 


Format: 


Mnemonic: SCF Operands: 
Object Code: 


0 0 1 1 0 1 +24 =I] 37 


Description: 
The C flag in the F register is set. 
M cycles: 1 T states: 4 4 MHz E.T:: 1.00 


Condition Bits Affected: 


S: Not affected 
Z: Not affected 
H: Reset 

P/V: Not affected 
N: Reset 

C: Set 


NOP No OPeration 


Operation: 


Format: 


Mnemonic: NOP Operands: 


Object Code: 


0 0 0 0 0 0 0 0; + @ 
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Description: 
CPU performs no operation during this machine cycle. 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 


Condition Bits Affected: None 


HALT 


Operation: 


Format: 


Mnemonic: HALT Operands: 
Object Code: 


O 1 1 1 0 1 21 ~=0 76 


Description: 


The HALT instruction suspends CPU operation until a subsequent interrupt or 
reset is received. While in the halt state, the processor will execute NOP’s to 
maintain memory refresh logic. 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 


Condition Bits Affected: None 


DI Disable Interrupts 
Operation: IFF G0 


Format: 


Mnemonic: DI Operands: 
Object Code: 


1 1 1 1 0 0 1 +&OT4 FB 











GENERAL PURPOSE ARITHMETIC AND CPU CONTROL GROUPS 


Description: 


DI disables the maskable interrupt by resetting the interrupt enable flip-flops 
(IFF1 and IFF2). Note that this instruction disables the maskable interrupt 
during its execution. 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 
Condition Bits Affected: None 


Example: 


When the CPU executes the instruction 
DI 


the maskable interrupt is disabled until it is subsequently re-enabled by an EI 
instruction. The CPU will not respond to an Interrupt Request (INT) signal. 


El Enable Interrupts 


Operation: IFF ¢ 1 


Format: 


Mnemonic: El Operands: 
Object Code: 


1 1 21 21 1 0 FT Dd FB 


Description: 


EI enables the maskable interrupt by setting the interrupt enable flip-flops (IFF1 
and IFF2). Note that this instruction disables the maskable interrupt during its 
execution. 


M cycles: 1 T states: 4 4 MHz E.T:: 1.00 
Condition Bits Affected: None 


Example: 
When the CPU executes instruction 
RETI 


the maskable interrupt is enabled. The CPU will now respond to an Interrupt 
Request (INT) signal. 
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IM Q Interrupt Mode 0 


Operation: 


Format: 


Mnemonic: IM Operands: 0 
Object Code: 


1 1 1 0 1 1 +0 = 4 ED 


0 1 0 0 0 1 1 =90 46 


Description: 


The IM 0 instruction sets interrupt mode @. In this mode the interrupting device 
can insert any instruction on the data bus and allow the CPU to execute it. The 

first byte of a multi-byte instruction is read during interrupt acknowledge cycle. 
Subsequent bytes are read in by a normal memory read sequence. 


M cycles: 2 T states: 8(4,4) 4 MHz E.T.: 2.00 


Condition Bits Affected: None 


IM 1 Interrupt Mode 1 


Operation: 


Format: 


Mnemonic: IM Operands: 1 


Object Code: 
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Description: 


The IM instruction sets interrupt mode 1. In this mode the processor will 
respond to an interrupt by executing a restart to location 0038H. 


M cycles: 2 T states: 8(4,4) 4 MHz E.T.: 2.00 


Condition Bits Affected: None 


IM 2 Interrupt Mode 2 
Operation: 


Format: 


Mnemonic: IM Operands: 2 


Object Code: 
1 1 1 0 1 1 +0 = =41 ED 
0 1 0 1 1 1 =21~=«~0 SE 
Description: 


The IM 2 instruction sets interrupt mode 2. This mode allows an indirect call to 
any location in memory. With this mode the CPU forms a 16-bit memory 
address. The upper eight bits are the contents of the Interrupt Vector Register I 
and the lower eight bits are supplied by the interrupting device. 


M cycles: 2 T states: 8(4,4) 4 MHz E.T.: 2.00 


Condition Bits Affected: None 
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16 Bit Arithmetic Group 
ADD HL,ss 


Operation: HLGHL+ ss 


Format: 
Mnemonic: ADD Operands: HL, ss 


Object Code: 


0 O s s 1 O0 O 1 


Description: 


The contents of register pair ss (any of register pairs BC, DE, HL or SP) are 
added to the contents of register pair HL, and the result is stored in HL. 
Operand ss is specified as follows in the assembled object code. 


Register 
Pair SS 
BC 00 
DE 01 
HL 10 
SP 11 


M cycles: 3 T states: 11(4,4,3) 4 MHz E.T.: 2.75 


Condition Bits Affected: 


S: Not affected 

Zz Not affected 

H: Set if carry out of Bit 11; reset otherwise 
P/V: Not affected 

N: Reset 

Cc Set if carry from Bit 15; reset otherwise 
Example: 


If register pair HL contains the integer 4242H and register pair DE contains 
1111H, after the execution of 


ADD HL, DE 
the HL register pair will contain 5353H. 
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ADC HL,ss ADd with Carry 


Operation: HLGHL+ ss + CY 


Format: 
Mnemonic: ADC Operands: HL, ss 


Object Code: 


Description: 


The contents of register pair ss (any of register pairs BC, DE, HL or SP) are 
added with the Carry Flag (C flag in the F register) to the contents of register 
pair HL, and the result is stored in HL. Operand ss is specified as follows in the 
assembled object code. 


Register 
Pair SS 
BC 00 
DE 01 
HL 10 
SP 11 


M cycles: 4 T states: 15(4,4,4,3) 4 MHz E.T.: 3.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Set if carry out of Bit 11; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Reset 

C: Set if carry from Bit 15; reset otherwise 
Example: 


If the register pair BC contains 2222H, register pair HL contains 5437H and the 
Carry Flag is set, after the execution of 


ADC HL, BC 
the contents of HL will be 765AH. 
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16 BIT ARITHMETIC GROUP 





SBC H Liss SuBtract with Carry 
Operation: HLGHL — ss — CY 


Format: 


Mnemonic: SBC Operands: HL, ss 


Object Code: 


Description: 


The contents of the register pair ss (any of register pairs BC, DE, HL or SP) 
and the Carry Flag (C flag in the F register) are subtracted from the contents of 
register pair HL and the result is stored in HL. Operand ss is specified as 
follows in the assembled object code. 


Register 
Pair SS 
BC 00 
DE 01 
HL 10 
SP 11 


M cycles: 4 T states: 15(4,4,4,3) 4 MHz E.T.: 3.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Set if borrow from Bit 12; reset otherwise 
P/V: Set if overflow; reset otherwise 

N: Set 

C: Set if borrow; reset otherwise 

Example: 


If the contents of the HL register pair are 9999H, the contents of register pair 
DE are 1111H, and the Carry Flag is set, after the execution of 


SBC HL, DE 
the contents of HL will be 8887H. 
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ADD IX,pp 


Operation: IX@IX+ pp 


Format: 


Mnemonic: ADD Operands: IX,pp 
Object Code: 


lt t! O 1 1 1 0 1 DD 


00 ppt 001 


Description: 


The contents of register pair pp (any of register pairs BC, DE, IX or SP) are 
added to the contents of the Index Register IX, and the results are stored in IX. 
Operand pp is specified as follows in the assembled object code. 


Register 
Pair pp 
BC 00 
DE 01 
IX 10 
SP 11 


M cycles: 4 T states: 15(4,4,4,3) 4 MHz E.T.: 3.75 


Condition Bits Affected: 


S: Not affected 

Zz. Not affected 

H: Set if carry out of Bit 11; reset otherwise 
P/V: Not affected 

N: Reset , 

C: Set if carry from Bit 15; reset otherwise 
Example: 


If the contents of Index Register [X are 3333H and the contents of register pair 
BC are 5555H, after the execution of 


ADD IX, BC 
the contents of [X will be 8888H. 
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ADD IY,rr 


Operation: lY (IY + rr 


Format: 


Mnemonic: ADD Operands: IY, rr 


Object Code: 


Description: 


The contents of register pair rr (any of register pairs BC, DE, IY or SP) are 
added to the contents of Index Register IY, and the result is stored in IY. 
Operand rr is specified as follows in the assembled object code. 


Register 
Pair rr 
BC 00 
DE 01 
IY 10 
SP 11 


M cycles: 4 T states: 15(4,4,4,3) 4 MHz E.T.: 3.75 


Condition Bits Affected: 


S: Not affected 

Z: Not affected 

H: Set if carry out of Bit 11; reset otherwise 
P/V: Not affected 

N: Reset 

C: Set if carry from Bit 15; reset otherwise 
Example: 


If the contents of Index Register IY are 333H and the contents of register pair 
BC are 555H, after the execution of 


ADD IY, BC 
the contents of TY will be 888H. 
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INC ss INCrement 


Operation: SS (SS + 1 


Format: 


Mnemonic: INC Operands: ss 
Object Code: 


0 0 s s 0 0 1 1 


Description: 


The contents of register pair ss (any of register pairs BC, DE, HL or SP) are 
incremented. Operand ss is specified as follows in the assembled object code. 


Register 
Pair SS 
BC 00 
DE 01 
HL 10 
SP 11 


M cycles: 1 T states: 6 4 MHz E.T.: 1.50 
Condition Bits Affected: None 


Example: 


If the register pair contains 1000H, after the execution of 
INC HL 
HL will contain 1001H. 


INC IX INCrement 


Operation: IX IX+ 1 


Format: 


Mnemonic: INC Operands: IX 
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16 BIT ARITHMETIC GROUP 


Object Code: 
1 1 0 1 1 1 0 1 DD 
0 0 1 0 0 0 1 ~=21 23 
Description: 


The contents of the Index Register [X are incremented. 
M cycles: 2 T states: 10(4,6) 4 MHz E.T:: 2.50 


Condition Bits Affected: None 


Example: 


If the Index Register [X contains the integer 3300H after the execution of 
INC IX 
the contents of Index Register IX will be 3301H. 


INC lY INCrement 


Operation: lY GIY + 1 


Format: 


Mnemonic: INC Operands: IY 


Object Code: 
1 1 1 1 #21 21 #0 ~=1 FD 
0 0 1 0 0 0 1 =41 23 
Description: 


The contents of the Index Register IY are incremented. 


M cycles: 2 T states: 10(4,6) 4 MHz E.T.: 2.50 


Condition Bits Affected: None 
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Example: 
* 


If the contents of the Index Register are 2977H, after the execution of 
INC IY 
the contents of Index Register [TY will be 2978H. 


DEC ss DECrement 


Operation: SS (SS — 1 


Format: 


Mnemonic: DEC Operands: ss 
Object Code: 


0 O s s 1 O 1 1 


Description: 


The contents of register pair ss (any of the register pairs BC, DE, HL or SP) are 
decremented. Operand ss is specified as follows in the assembled object code. 


Register 
Pair SS 
BC 00 
DE 01 
HL 10 
SP 11 


M cycles: 1 T states: 6 4 MHz E.T:.: 1.50 
Condition Bits Affected: None 


Example: 


If register pair HL contains 1001H, after the execution of 
DEC HL 
the contents of HL will be 1000H. 
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DEC IX 


Operation: IX 41X— 1 


Format: 

Mnemonic: DEC Operands: IX 
Object Code: 

1 1 0 1 1 #1 +0 ~=41 DD 
0 0 1 0 1 0 1 ~=21 2B 
Description: 


The contents of Index Register [IX are decremented. 


M cycles: 2 T states: 10(4,6) 4 MHz E.T.: 2.50 
Condition Bits Affected: None 


Example: 


16 BIT ARITHMETIC GROUP 


DECrement 


If the contents of Index Register IX are 2006H, after the execution of 


DEC IX 
the contents of Index Register IX will be 2005H. 


DEC IY 


Operation: lY GIY— 1 


Format: 


Mnemonic: DEC Operands: IY 


Object Code: 
Lot. & 1-t. 2. 0.4 FD 
0 0 1 0 1 0 1 =41 2B 


DECrement 
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Description: 
The contents of the Index Register IY are decremented. 
M cycles: 2 T states: 10(4,6) 4 MHz E.T.: 2.50 


Condition Bits Affected: None 


Example: 


If the contents of the Index Register [TY are 7649H, after the execution of 
DEC IY 
the contents of Index Register TY will be 7648H. 
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Rotate and Shift Group 


RLCA Rotate Left Circular Accumulator 
Operation: ol 740 | « | 
A 
Format: 


Mnemonic: RLCA Operands: 
Object Code: 


0 0 0 0 0 1 +21 +14 ~~ «=@7 


Description: 


The contents of the Accumulator (register A) are rotated left: the content of bit 0 
is moved to bit 1; the previous content of bit 1 is moved to bit 2; this pattern is 
continued throughout the register. The content of bit 7 is copied into the Carry 
Flag (C flag in register F) and also into bit Q. (Bit @ is the least significant bit.) 


M cycles: 1 T states: 4 4 MHz E.T:: 1.00 
Condition Bits Affected: 


S: Not affected 

ZL Not affected 

H: Reset 

P/V: Not affected 

N: Reset 

C: Data from Bit 7 of Acc. 
Example: 


If the contents of the Accumulator are 
7 6 5 4 3 2 1 =~0 


to} ofojifojlojo. 


after the execution of 
RLCA 
the contents of the Carry Flag and the Accumulator will be 


C 7 65 4 3 2 1 =0 


Ofolotifojojol{i 
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RLA Rotate Left Accumulator 


SecationGY “HH 740 4 
A 


Format: 


Mnemonic: RLA Operands: 
Object Code: 


0 0 0 1 0°11 1 ~=«21 17 


Description: 


The contents of the Accumulator (register A) are rotated left: the content of bit 0 
is copied into bit 1; the previous content of bit 1 is copied into bit 2; this pattern 
is continued throughout the register. The content of bit 7 is copied into the Carry 
Flag (C flag in register F) and the previous content of the Carry Flag is copied 
into bit @. Bit @ is the least significant bit. 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 


Condition Bits Affected: 


S: Not affected 

Z: Not affected 

H: Reset 

P/V: Not affected 

N: Reset 

Cc Data from Bit 7 of Acc. 
Example: 


If the contents of the Carry Flag and the Accumulator are 
C 7 6 5 4 3 2 41 ~=«~0 


after the execution of 
RLA 
the contents of the Carry Flag and the Accumulator will be 


C 7 65 4 3 2 1 =O 


Lo} (ifatifotitijfoji 
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RRCA Rotate Right Circular Accumulator 
Operation: DY 

A 
Format: 


Mnemonic: RRCA Operands: 
Object Code: 


0 0 0 0 1 1 +1 +1 ~~ OF 


Description: 


The contents of the Accumulator (register A) are rotated right: the content of bit 
7 is copied into bit 6; the previous content of bit 6 is copied into bit 5; this 
pattern is continued throughout the register. The content of bit @ is copied into 
bit 7 and also into the Carry Flag (C flag in register F.) Bit @ is the least 
significant bit. 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 


Condition Bits Affected: 


S: Not affected 

Z: Not affected 

H: Reset 

P/V: Not affected 

N: Reset 

Cc: Data from Bit @ of Acc. 
Example: 


If the contents of the Accumulator are 
7 6 5 4 3 2 #1 =~0 


OfoOfolijojlojol{i 


After the execution of 
RRCA 
the contents of the Accumulator and the Carry Flag will be 


7 6 5 4 3 2 1 0 +C€C 


110 }OlOj {Oj ojo! 
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RRA Rotate Right Accumulator 
Operation: 

A 
Format: 


Mnemonic: RRA Operands: 
Object Code: 


0 0 0 1 1 1 1 It SIF 


Description: 


The contents of the Accumulator (register A) are rotated right: the content of 
bit 7 is copied into bit 6; the previous content of bit 6 is copied into bit 5; this 
pattern is continued throughout the register. The content of bit 0 is copied into 
the Carry Flag (C flag in register F) and the previous content of the Carry Flag 
is copied into bit 7. Bit @ is the least significant bit. 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 


Condition Bits Affected: 


S: Not affected 

LZ Not affected 

H: Reset 

P/V: Not affected 

N: Reset 

C: Data from Bit @ of Acc. 
Example: 


If the contents of the Accumulator and the Carry Flag are 
7 6 5 4 3 2 1 =O C 


fififtifofofofotij [ol] 


after the execution of 
RRA 
the contents of the Accumulator and the Carry Flag will be 


TO 3 4°53 2 Tt @ << 


EO LAA 10/2020) 0) 
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RLC r Rotate Left Circular 
Operation: 

r 
Format: 


Mnemonic: RLC Operands: r 


Object Code: 


Description: 


The eight-bit contents of register r are rotated left: the content of bit @ is copied 
into bit 1; the previous content of bit 1 is copied into bit 2; this pattern is 
continued throughout the register. The content of bit 7 is copied into the Carry 
Flag (C flag in register F) and also into bit @. Operand r is specified as follows 
in the assembled object code: 


Register r 
B 000 
C 001 
D 010 
E 011 
H 100 
L 101 
A 111 


Note: Bit @ is the least significant bit. 
M cycles: 2 T states: 8(4,4) 4 MHz E.T.: 2.00 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Zz: Set if result is zero; reset otherwise 

H: Reset 

P/V: Set if parity even; reset otherwise 

N: Reset 

Cc. Data from Bit 7 of source register 
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Example: 
If the contents of register r are 


7 6 5 4 3 2 1 =O 


Iiof/olojijojojo 


after the execution of 
RLC r 
the contents of the Carry Flag and register r will be 


C 7 6 5 4 3 2 1 ~=«0 


100 [1 0) 6 071: 


RLC (Hi L) Rotate Left Circular 
Operation: 
HL) 


Format: 


Mnemonic: RLC Operands: (HL) 


Object Code: 


1 1 0 0 1 0 1 +1] CB 


Description: 


The contents of the memory address specified by the contents of register pair 
HL are rotated left: the content of bit 0 is copied into bit 1; the previous content 
of bit 1 is copied into bit 2; this pattern is continued throughout the byte. The 
content of bit 7 is copied into the Carry Flag (C flag in register F) and also into 
bit @. Bit @ is the least significant bit. 


M cycles: 4 T states: 15(4,4,4,3) 4 MHz E.T.: 3.75 
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Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Reset 

P/V: Set if parity even; reset otherwise 

N: Reset 

© Data from Bit 7 of source register 
Example: 


If the contents of the HL register pair are 2828H, and the contents of memory 
location 2828H are 


7 6 5 4 3 2 1 ~=«~0 


ifoloj}olifojojo 


after the execution of 
RLC (HL) 
the contents of the Carry Flag and memory locations 2828H will be 


C 7 6 5 4 3 2 1 =0 


OL OO; tf olojoji 


RLC (IX+ d) Rotate Left Circular 


Operation: 
+ 


Mnemonic: RLC Operands: (IX+ d) 


Object Code: 
1 1 0 1 1 1 0 =1 DD 
1 1 0 0 1 0 1 ~=41 CB 


d dddddqdéq4d 


0 0 0 0 0 1 1 =+0 06 
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Description: 


The contents of the memory address specified by the sum of the contents of the 
Index Register [IX and a two’s complement displacement integer d, are rotated 
left: the contents of bit 0 is copied into bit 1; the previous content of bit 1 is 
copied into bit 2; this pattern is continued throughout the byte. The content of 
bit 7 is copied into the Carry Flag (C flag in register F) and also into bit 0. Bit 0 
is the least significant bit. 


M cycles: 6 T states: 23(4,4,3,5,4,3) 4 MHz E.T.: 5.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
ZL Set if result is zero; reset otherwise 

H: Reset 

P/V: Set if parity even; reset otherwise 

N: Reset : 

Cc: Data from Bit 7 of source register 
Example: 


If the contents of the Index Register IX are 1000H, and the contents of memory 
location 1002H are 


7 6 5 4 3 2 1 ~=«0 


ifofolojijojojo 


after the execution of 
RLC (IX+2H) | 
the contents of the Carry Flag and memory location 1002H will be 


C 7 6 5 4 3 2 1 =«0 


Of OTO} 1} oOjojoyr 


RLC (IY+ d) Rotate Left Circular 
Operation: 


(Y+d 


Format: 


Mnemonic: RLC Operands: (IY + d) 
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Object Code 
1 1 1 1 421 21 ~0 =41 FD 
1! 1 0 0 1 0 1 =41 CB 


d dddddqdéq4d 


0 0 0 0 0 1 +1 ~=«0 06 


Description: 


The contents of the memory address specified by the sum of the contents of the 
Index Register IY and a two’s complement displacement integer d are rotated 
left: the content of bit @ is copied into bit 1; the previous content of bit 1 is 
copied into bit 2; this process is continued throughout the byte. The content of 
bit 7 is copied into the Carry Flag (C flag in register F) and also into bit 0. Bit @ 
is the least significant bit. 


M cycles: 6 T states: 23(4,4,3,5,4,3) 4 MHz E.T.: 5.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Reset 

P/V: Set if parity even; reset otherwise 

N: Reset 

C: Data from Bit 7 of source register 
Example: 


If the contents of the Index Register IY are 100QH, and the contents of memory 
location 1002H are 


7 6 5 4 3 2 1 =«0 


1 LOlofolijo/ ojo, 
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after the execution of 
RLC (IY¥+2H) 
the contents of the Carry Flag and memory location 1002H will be 


C 7 6 5 4 3 2 1 =«0 


OfOlToOtifojoloji 


RL m Rotate Left 


Operation: GY) tH 740 A 


Format: 


AB 


Mnemonic: RL Operands: m 


The m operand is any of r, (HL), (IX+d) or ([TY+d), as defined for the 
analogous RLC instructions. These various possible opcode-operand 
combinations are specified as follows in the assembled object code: 


Object Code: 

RLr 1 1 0 0 1 0 1 41 CB 

RL (HL) 1 1 0 0 1 0 1 =41 CB 
0 0 0 1 0 1 +1 ~=+0 16 
1 1 0 0 1 0 1 1 CB 
0 0 0 1 0 1 +1 ~=«~0 16 
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RL (fY + d) 1 1 21 21 =21 21 0 41 FD 
cs 
0 0 0 1 0 1 1 =~0 16 


r identifies register B, C, D, E, H, L or A specified as follows in the assembled 
object code above: 


Register r 


B 000 
C 001 
D 010 
E 011 
H 100 
L 101 
A 111 
Description: 


The contents of the m operand are rotated left: the content of bit @ is copied into 
bit 1; the previous content of bit 1 is copied into bit 2; this pattern is continued 
throughout the byte. The content of bit 7 is copied into the Carry Flag (C flag in 
register F) and the previous content of the Carry Flag is copied into bit @. Bit 0 
is the least significant bit. 


M 4 MHz 
Instruction Cycles T States E.T. in ps 
RLr 2 8(4,4) 2.00 
RL (HL) 4 15(4,4,4,3) 3.75 
RL (IX+ d) 6 23(4,4,3,5,4,3) 5.75 
RL (fY+d) 6 23(4,4,3,5,4,3) 5.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Reset 

P/V: Set if parity even; reset otherwise 

N: Reset 

C: Data from Bit 7 of source register 
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Example: 

If the contents of the Carry Flag and register D are 
C 7 6 5 4 3 2 1 ~=«~0 

fo} {i fojfofof{ifiqi]i| 

after the execution of 


RL D 
the contents of the Carry Flag and register D will be 


C 7 6 5 4 3 2 1 =0 


Of OTOt tir t iri fol 


RRC m Rotate Right Circular 
Operation:'y [70 Ie 
m 


Format: 
Mnemonic: RRC Operands: m 


The m operand is any of r, (HL), (IX+d) or ([Y+d), as defined for the 
analogous RLC instructions. These various possible opcode-operand 
combinations are specified as follows in the assembled object code: 


Object Code: 


RRCr 1 t 0 0O 1 0 1 +14 +CB 


RRC (HL) 1 1 0 0 1 0 1 ~=«21 CB 


0 0 0 0 1 1 +1 ~=«0 OE 
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RRC (IX+ d) 1 1 0 1 1 1 #0 = 1 DD 


me 
i 
© 
© 
— 
© 
— 
pe 


CB 


d dddddqdéq4d 


0 0 0 0 1 1 +1 =«0 OE 


RRC (IY+d) 1 t 1 1 1 ~=21 +0 =41 FD 


© 


CB 


|d déodddddéqd 


jaa 
ea 
© 
© 
— 
a 
pai 


0 0 0 0 1 1 +21 ~=«~0 OE 


r identifies register B, C, D, E, H, L or A specified as follows in the assembled 
object code above: 


Register r 


B 000 
C 001 
D 010 
E 011 
H 100 
L 101 
A 111 
Description: 


The contents of operand m are rotated right: the content of bit 7 is copied into 
bit 6; the previous content of bit 6 is copied into bit 5; this pattern is continued 
throughout the byte. The content of bit 0 is copied into the Carry Flag (C flag in 
the F register) and also into bit 7. Bit @ is the least significant bit. 
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M 4 MHz 
Instruction Cycles T States E.T. in ps 
RRC r 2 8(4,4) 2.00 
RRC (HL) 4 15(4,4,4,3) 3.75 
RRC (IX+ d) 6 23(4,4,3,5,4,3) 5.75 
RRC (1Y+d) 6 23(4,4,3,5,4,3) 5.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Reset 

P/V: Set if parity even; reset otherwise 

N: Reset 

C: Data from Bit @ of source register 
Example: 


If the contents of register A are 


7 6 5 4 3 2 41 ~=«0 


OLOti{ 1} oOfojoji | 


after the execution of 
RRC A 
the contents of register A and the Carry Flag will be 


7 6 5 4 3 2 1 0 +C 


TO; ot ijt ojojo. 


RRM Rotate Right 


menial’ ) ey 


mM 
Format: 


Mnemonic: RR Operands: m 


The m operand is any of r, (HL), (IX+d) or ([Y+d), as defined for the 
analogous RLC instructions. These various possible opcode-operand 
combinations are specified as follows in the assembled object code: 
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Object Code: 

RRr 1 1 0 0 1 0 1 =1 CB 
0 0 O 1 1 sr r ir 

RR (HL) 1 1 0 0 1 0 1 =«21 CB 
0 0 0 1 1 21 ~=21 ~=~0 1E 

RR (IX+ d) 1 1 0 1 21 +21 =0~=21 DD 
: 
0 0 0 1 1 +21 ~=21 ~=~0 1E 
1 1 0 0 1 0 1 1 CB 
0 0 0 1 1 1 21 =90 lE 


r identifies registers B, C, D, E, H, L or A specified as follows in the assembled 
object code above: 


Register r 
000 
001 
010 
011 
100 
101 
111 


rrimondnw 
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Description: 


The contents of operand m are rotated right: the contents of bit 7 is copied into 
bit 6; the previous content of bit 6 is copied into bit 5; this pattern is continued 
throughout the byte. The content of bit @ is copied into the Carry Flag (C flag in 
register F) and the previous content of the Carry Flag is copied into bit 7. Bit 0 
is the least significant bit. 


M 4 MHz 
Instruction Cycles T States E.T. in pws 
RR r 2 8(4,4) 2.00 
RR (HL) 4 15(4,4,4,3) 3.75 
RR (IX+ d) 6 23(4,4,3,5,4,3) 5.75 
RR (ITY +d) 6 23(4,4,3,5,4,3) 5.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Reset 

P/V: Set if parity is even; reset otherwise 

N: Reset 

C: Data from Bit 0 of source register 
Example: 


If the contents of the HL register pair are 4343H, and the contents of memory 
location 4343H and the Carry Flag are 


7 6 5 4 3 2 1 0 =+C 


ete 07) te) a sO] A] 04 

after the execution of 

RR (HL) 

the contents of location 4343H and the Carry Flag will be 
7 6 5 4 3 2 1 ~=«0 C 


PO Oem | Ae Os 


SLA m Shift Left Arithmetic 
Operation: ‘ 0 

mM 
Format: 


Mnemonic: SLA Operands: m 
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The m operand is any of r, (HL), (IX+d) or ([Y+d), as defined for the 
analogous RLC instructions. These various possible opcode-operand 
combinations are specified as follows in the assembled object code: 


Object Code: 

SLA r 1 1 0 0 1 0 1 1 CB 
0 0 1 0 0 r r r 

SLA (HL) 1 1 0 0 1 0 1 =41 CB 
0 0 1 0 0 1 1 =0 26 

SLA ([X+ d) 1 1 0 1 21 21 ~=40~=41 DD 
1 1 0 0 1 0 1 ~=«1 CB 
0 0 1 0 0 1 1 =0 26 
1 1 0 0 1 0 1 =«1 CB 
0 0 1 0 0 1 1 =90 26 


r identifies registers B, C, D, E, H, L or A specified as follows in the assembled 
object code field above: 
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Register r 
B 000 
C 001 
D 010 
E 011 
H 100 
L 101 
A 111 

Description: 


An arithmetic shift left is performed on the contents of operand m: bit Q is reset, 
the previous content of bit 0 is copied into bit 1, the previous content of bit 1 is 
copied into bit 2; this pattern is continued throughout; the content of bit 7 is 
copied into the Carry Flag (C flag in register F). Bit @ is the least significant bit. 


M 4 MHz 
Instruction Cycles T States E.T. in ws 
SLA r 2 8(4,4) 2.00 
SLA (HL) 4 15(4,4,4,3) 3.75 
SLA (IX+ d) 6 23(4,4,3,5,4,3) 5.75 
SLA (IY+ d) 6 23(4,4,3,5,4,3) 5.75 


Condition Bits Affected: 


5: Set if result is negative; reset otherwise 
Z: Set if result is zero; reset otherwise 

H: Reset 

P/V: Set if parity is even; reset otherwise 
N: Reset 

C Data from Bit 7 

Example: 


If the contents of register L are 
7 6 5 4 3 2 1 ~=«0 


pifofijijojojoji 


after the execution of 
SLA L 
the contents of the Carry Flag and register L will be 


C 7 6 5 4 3 2 1 =O 


Ofi {if ojofojijo. 
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ROTATE AND SHIFT GROUP 


SRA m Shift Right Arithmetic 


Operation: | ZO A 
om . 
Format: 


Mnemonic: SRA Operands: m 


The m operand 1s any of r, (HL), ([IX+d) or ([Y+d), as defined for the 
analogous RLC instructions. These various possible opcode-operand 
combinations are specified as follows in the assembled object code: 


Object Code: 

SRA r 1 1 0 0 1 0 1 1 CB 
O 0 1 0 1 sr r rr 

SRA (HL) 1 1 0 0 1 0 1 1 CB 

* 

SRA (IX+ d) 1 1 0 1 1 21 #0 = =41 DD 
1 1 0 0 1 0 1 =41 CB 
0 0 1 0 1 1 +1 ~=«90 2E 
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SRA (TY +d) D&D oe dk BUD FD 


0 0 1 0 1 +1 «21 ~=«~90 2E 


r means register B, C, D, E, H, L or A specified as follows in the assembled 
object code field above: 


Register r 


000 
001 
010 
011 
100 
101 
111 


rrimone 


An arithmetic shift right is performed on the contents of operand m: the content 
of bit 7 is copied into bit 6; the previous content of bit 6 is copied into bit 5; this 
pattern is continued throughout the byte. The content of bit @ is copied into the 

Carry Flag (C flag in register F), and the previous content of bit 7 is unchanged. 
Bit @ is the least significant bit. 


M 4 MHz 
Instruction Cycles T States E.T. in ws 
SRA r 2 8(4,4) 2.00 
SRA (HL) 4 15(4,4,4,3) 3.75 
SRA (IX+ d) 6 23(4,4,3,5,4,3) 575 
SRA (IY+ d) 6 23(4,4,3,5,4,3) 5.75 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Zz: Set if result is zero; reset otherwise 

H: Reset 

P/V: Set if parity is even; reset otherwise 

N: Reset 

c Data from Bit @ of source register 
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ROTATE AND SHIFT GROUP 


Example: 


If the contents of the Index Register [X are 1000H, and the contents of memory 
location 1003H are 


7 6 5 4 3 2 1 ~=«0 


tot ijtiiijojojo 


after the execution of 
SRA (IX+3H) 
the contents of memory location 1003H and the Carry Flag will be 


7 6 35 4 3 2 1 0 +:C€C 


Alto Ltt fs Toyo} o 


SRL m Shift Right Logical 
Operation: (),) 

mM 
Format: 


Mnemonic: SRL Operands: m 


The operand m is any of r, (HL), ([X+d) or ([Y+d), as defined for the 
analogous RLC instructions. These various possible opcode-operand 
combinations are specified as follows in the assembled object code: 


Object Code: 

SRL r 1 1 0 041 0 1 =1 CB 
0 0 1 1 1 +r sr ir 

SRL (HL) 1 1 0 0 1 0 1 =1 CB 
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SRL (IX+ d) 1 1 0 1 1 +1 ~=0=41 DD 


1 t 0 0 1 0 1 41 CB 
| d dddddqdéq4d | 
0 O 1 1 1 21 ~21 =~0 3E 
SRL ((Y+ d) 1 1 1 =! 1 1 0 1 FD 
1 t 0O 0 1 0 1 =41 CB 
0 O 1 1 1 21 21 ~=~0 3E 


r identifies registers B, C, D, E, H, Lor A specified as follows in the assembled 
object code fields above: 


Register r 
B 000 
C 001 
D 010 
E 011 
H 100 
L 101 
A 111 

Description: 


The contents of operand m are shifted right: the content of bit 7 is copied into 
bit 6; the content of bit 6 is copied into bit 5; this pattern is continued 
throughout the byte. The content of bit @ is copied into the Carry Flag, and bit 7 
is reset. Bit 0 is the least significant bit. 
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M 4 MHz 
Instruction Cycles T States E.T. in ps 
SRL r 2 8(4,4,) 2.00 
SRL (HL) 4 15(4,4,4,3) 3.75 
SRL (IX+ d) 6 23(4,4,3,5,4,3) 5.75 
6 23(4,4,3,5,4,3) 5.75 


SRL (TY+ d) 


Condition Bits Affected: 


S: Set if result is negative; reset otherwise 
Z: Set if result 1s zero; reset otherwise 

H: Reset 

P/V: Set if parity is even; reset otherwise 

N: Reset 

Cc: Data from Bit @ of source register 
Example: 


If the contents of register B are 


7 6 5 4 3 2 +41 ~=«~0 


ptyofojojiay it aya 


after the execution of 
SRL B 
the contents of register B and the Carry Flag will be 


7 6 5 4 3 2 1 0 =+C 


O11 olof;otriiya 


RLD Rotate Left Decimal 
Operation: (HL) 
Format: c t 


Mnemonic: RLD Operands: 
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Object Code: 
1 1 1 0 1 1 +0 = 41 ED 
0 1 1 0 1 1 21 ~«21 6F 
Description: 


The contents of the low order four bits (bits 3, 2, 1 and 0) of the memory 
location (HL) are copied into the high order four bits (7, 6, 5 and 4) of that same 
memory location; the previous contents of those high order four bits are copied 
into the low order four bits of the Accumulator (register A), and the previous 
contents of the low order four bits of the Accumulator are copied into the low 
order four bits of memory location (HL). The contents of the high order bits of 
the Accumulator are unaffected. Note: (HL) means the memory location 
specified by the contents of the HL register pair. 


M cycles: 5 T states: 18(4,4,3,4,3) 4 MHz E.T.: 4.50 


Condition Bits Affected: 


Set if Acc. is negative after operation; reset otherwise 

Set if Acc. is zero after operation; reset otherwise 

Reset 

Set if parity of Acc. is even after operation; reset otherwise 
Reset 

Not affected 


QAAZVAINS 
oe 


Example: 


If the contents of the HL register pair are 50QQH, and the contents of the 
Accumulator and memory location 5000H are 


7 6 5 4 3 2 1 =40 


OAL A PTT AOL T| oO} — Accumulator 


7 6 5 4 3 2 «1 ~=«0 


POLO; }O;O};O} 1} — (5000H) 
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TPT I ES 


after the execution of 
RLD 
the contents of the Accumulator and memory location 5000H will be 


7 6 5 4 3 2 1 =«0 


OL Ltt A} OPOt rt} — Accumulator 


7 6 5 4 3 2 1 =«0 


OLOLO TT} TLO}1}O} — (5000H) 






RRD Rotate Right Decimal 
Operation: A (H L) 
C3 
Format: 
Mnemonic: RRD Operands: 
Object Code: 
1 1 1 0 1 1 =0 = 1 ED 
0 1 1 0 0 1 1 =1 67 
Description: 


The contents of the low order four bits (bits 3, 2, 1 and ®) of memory location 
(HL) are copied into the low order four bits of the Accumulator (register A); the 
previous contents of the low order four bits of the Accumulator are copied into 
the high order four bits (7, 6, 5 and 4) of location (HL); and the previous 
contents of the high order four bits of (HL) are copied into the low order four 
bits of (HL). The contents of the high order bits of the Accumulator are 
unaffected. Note: (HL) means the memory location specified by the contents 

of the HL register pair. 


M cycles: 5 T states: 18(4,4,3,4,3) 4 MHz E.T.: 4.50 


Condition Bits Affected: 
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Set if Acc. is negative after operation; reset otherwise 

Set if Acc. is zero after operation; reset otherwise 

Reset 

Set if parity of Acc. is even after operation; reset otherwise 
Reset 

Not affected 


QZVINYG 
eae 


Example: 


If the contents of the HL register pair are 50Q0H, and the contents of the 
Accumulator and memory location 5000H are 


7 6 5 4 3 2 1 ~=~0 
TTOLOTOTO[1 [0] 0] — Accumutator 


7 6 5 4 3 2 1 =40 


OLOFT{OLO{O}O}O)} — (5000H) 


after the execution of 
RRD 
the contents of the Accumulator and memory location 5000H will be 


F654 32> 7 O 
1 {OlO}O}O}O{O}O} Accumulator 


7 6 5 4 3 2 41 ~=«~0 


O11 fO}O;O;O} 10} — (5000) 
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Bit Set, Reset and ‘Test Group 
BIT b, [ BIT test 


Operation: Z 4 i" 


Format: 


Mnemonic: BIT Operands: b, r 
Object Code: 


1 1 0 0 1 0 1 +1 CB 


0 1 b b beer er rr 


Description: 


After the execution of this instruction, the Z flag in the F register will contain 
the complement of the indicated bit within the indicated register. Operands b 
and r are specified as follows in the assembled object code: 


Bit 
Tested b Register r 

0 000 B 000 
1 001 C 001 
2 010 D 010 
3 011 E 011 
4 100 H 100 
5 101 i; 101 
6 110 A 111 
7 111 


M cycles: 2 T states: 8(4,4) 4 MHz E.T.: 2.00 


Condition Bits Affected: 


S: Unknown 

Z: Set if specified Bit is 0; reset otherwise 
H: Set 

P/V: Unknown 

N: Reset 

C: Not affected 
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Example: 


If bit 2 in register B contains Q, after the execution of 
BIT 2, B 


the Z flag in the F register will contain 1, and bit 2 in register B will remain Q. 
(Bit @ in register B is the least significant bit.) 


BIT b,(HL) Bit Test 


Operation: 24 (H L), 


Format: 


Mnemonic: BIT Operands: b, (HL) 
Object Code: 


1 1 0 0 1 0 1 =%dy CB 


0 1 bb b 1 1 =O 


Description: 


This instruction tests bit b in the memory location specified by the contents of 
the HL register pair and sets the Z flag accordingly. Operand b 1s specified as 
follows in the assembled object code: 


Bit 

Tested b 
0 000 
l 001 
2 010 
3 011 
4 100 
5 101 
6 110 
7 111 


M cycles: 3 T states: 12(4,4,4) 4 MHz E.T.: 3.00 


Condition Bits Affected: 
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BIT SET, RESET AND TEST GROUP 


Unknown 

Set if specified Bit 1s @; reset otherwise 
Set 

Unknown 

Reset 

Not affected 


QtvVAoINe 
a 


Example: 


If the HL register pair contains 444H, and bit 4 in the memory location 444H 
contains 1, after the execution of 


BIT 4,(HL) 


the Z flag in the F register will contain 0, and bit 4 in memory location 444H 
will still contain 1. (Bit @ in memory location 444H is the least significant bit.) 


BIT b,(IX+ d) Bit Test 


Operation: Z 4 (IX+ d), 


Format: 


Mnemonic: BIT Operands: b, ([X+ d) 


Object Code: 
Ll 1 0 1 21 21 0 ~=1 DD 
1 1 0 0 1 0 1 =41 CB 


d dddddqdée4qd 


0 1 b b b 1 1 =+0 


Description: 


After the execution of this instruction, the Z flag in the F register will contain 
the complement of the indicated bit within the contents of the memory location 
pointed to by the sum of the contents register pair [IX (Index Register IX) and 
the two’s complement displacement integer d. Operand b is specified as follows 
in the assembled object code. 
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M cycles: 5 T states: 20(4,4,3,5,4) 4 MHz E.T.: 5.00 
Condition Bits Affected: 


S: Unknown 

Z: Set if specified Bit is @; reset otherwise 
H: Set 

P/V: Unknown 

N: Reset 

C: Not affected 

Example: 


If the contents of Index Register [IX are 2000H, and bit 6 in memory location 
2004H contains 1, after the execution of 


BIT 6,(1X+4H) 


the Z flag in the F register will contain @, and bit 6 in memory location 2004H 
will still contain 1. (Bit @ in memory location 2004H is the least significant bit.) 


BIT p,(IY+ d) BIT Test 


Operation: Z4 (IY +d), 

Format: 

Mnemonic: BIT Operands: b, (IY +d) 
Object Code: 

1 1 1 1 +21 +21 =0~«1 FD 
1 1 0 0 1 0 1 1 CB 


oma 
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Description: 


After the execution of this instruction, the Z flag in the F register will contain 
the complement of the indicated bit within the contents of the memory location 
pointed to by the sum of the contents of register pair TY (Index Register IY) and 
the two’s complement displacement integer d. Operand b is specified as follows 
in the assembled object code: 


Bit 
Tested b 
0 000 
1 001 
2 010 
3 011 
4 100 
5 101 
6 110 
7 111 


M cycles: 5 T states: 20(4,4,3,5,4) 4 MHz E.T.: 5.00 


Condition Bits Affected: 


5: Unknown 

Z: Set if specified Bit is 0; reset otherwise 
H: Set 

P/V: Unknown 

N: Reset 

C: Not affected 

Example: 


If the contents of Index Register are 2000H, and bit 6 in memory location 
2004H contains 1, after the execution of 


BIT 6,(1Y+4H) 


the Z flag in the F register still contain @, and bit 6 in memory location 2004H 
will still contain 1. (Bit @ in memory location 2004H is the least significant bit.) 


SET b,r 


Operation: I, 4 1 


Format: 


Mnemonic: SET Operands: b, r 
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Object Code: 


1 1 0 0 1 0 1 +214] +CB 


Description: 


Bit b (any bit, 7 through Q) in register r (any of register B, C, D, E, H, Lor A) 
is set. Operands b and r are specified as follows in the assembled object code: 


Bit 
Tested b Register r 

1) 000 B 000 
1 001 C 001 
2 010 D 010 
3 011 E 011 
4 100 H 100 
5 101 L 101 
6 110 A 111 
7 111 


M cycles: 2 T states: 8(4,4) 4 MHz E.T.: 2.00 
Condition Bits Affected: None 


Example: 


After the execution of 
SET 4,A 
bit 4 in register A will be set. (Bit @ is the least significant bit.) 


SET b,(HL) 


Operation: (HL), 41 


Format: 


Mnemonic: SET Operands: b, (HL) 
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Object Code: 


1 1 0 0 1 0 1 +1 CB 


1 1 bb bt 1 =O 


Description: 


Bit b (any bit, 7 through @) in the memory location addressed by the contents of 
register pair HL is set. Operand b is specified as follows in the assembled object 


code: 
Bit 
Tested b 
0 000 
1 001 
2 010 
3 011 
4 100 
5 101 
6 110 
7 111 


M cycles: 4 T states: 15(4,4,4,3) 4 MHz E.T.: 3.75 
Condition Bits Affected: None 


Example: 


If the contents of the HL register pair are 3000H, after the execution of 
SET 4,(HL) 


bit 4 in memory location 3000H will be 1. (Bit @ in memory location 3000H 
is the least significant bit.) 


SET b,(IX+ d) 


Operation: (IX+d),41 


Format: 


Mnemonic: SET Operands: b, (IX+ d) 
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Object Code: 


DD 


CB 


_ —_ 
— — 
© © 
oO — 
pecreeh pees 
& — 
— o 
_— —_ 


ddddddqdéeéq4d 


1 1 bb be 1 1 =O 


Description: 


Bit b (any bit, 7 through Q) in the memory location addressed by the sum of the 
contents of the IX register pair (Index Register IX) and the two’s complement 
integer d is set. Operand b is specified as follows in the assembled object code: 


Bit 

Tested b 
Q 000 
1 001 
2 010 
3 O11 
4 100 
5 101 
6 110 
7 111 


M cycles: 6 T states: 23(4,4,3,5,4,3) 4 MHz E.T.: 5.75 
Condition Bits Affected: None 


Example: 


If the contents of Index Register are 2000H, after the execution of 
SET 0,([X+ 3H) 


bit @ in memory location 2003H will be 1. (Bit ® in memory location 2003H 
is the least significant bit.) | 


—_ 
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SET b,(IY+d) 


Operation: (lY + d),41 


Format: 


Mnemonic: SET Operands: b, (ITY +d) 


Object Code: 
1 1 1 21 #21 ~=21 ~=0 =41 FD 
1 1 0 0 1 0 1 =1 CB 


d dddd dq déqd 


1 1 bb bo 1 1 =O 


Description: 


Bit b (any bit, 7 through @) in the memory location addressed by the sum of the 
contents of the IY register pair (Index Register IY) and the two’s complement 
displacement d is set. Operand b is specified as follows in the assembled object 
code: 


Bit 
Tested b 
0 000 
1 001 
2 010 
3 011 
4 100 
5 101 
6 110 
7 111 


M cycles: 6 T states: 23(4,4,3,5,4,3) 4 MHz E.T:: 5.75 


Condition Bits Affected: None 
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Example: 


If the contents of Index Register [TY are 2000H, after the execution of 
SET 0,(7Y+3H) 


bit @ in memory location 2003H will be 1. (Bit @ in memory location 2003H 
is the least significant bit.) 


RES b,m RESet 


Operation: S, (0 


Format: 
Mnemonic: RES Operands: b, m 


Operand b is any bit (7 through Q) of the contents of the m operand, (any of r, 
(HL), (IX+ d) or ([Y+d) as defined for the analogous SET instructions. These 
various possible opcode-operand combinations are assembled as follows in the 
object code: 


Object Code: 

RES b, r 1 1 0 0 1 0 1 ~=«41 CB 
1 O b b bor yr r 

RES b, (IX+d) 1 1 0 1 1 21 0 =1 DD 
1 1 0 0 1 0 1 ~=1 CB 


d dddddqdéqd 


1 O b b b 1 1 =O 
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RES b, (TY+d) Pb twa EO FD 


dddddddéq4d 


1 0 b b b 1 1 =0 


Bit 
Reset b Register r 

0 000 B 000 
1 001 C 001 
2 010 D 010 
3 011 E 011 
4 100 H 100 
5 101 L 101 
6 110 A 111 
7 111 

Description: 


Bit b in operand m 1s reset. 


M 4 MHz 
Instruction Cycles T States E.T. in ws 
RES r 4 8(4,4) 2.00 
RES (HL) 4 15(4,4,4,3) 3.75 
RES (IX+ d) 6 23(4,4,3,5,4,3) 5.75 
RES (IY +d) 6 23(4,4,3,5,4,3) \.15 


Condition Bits Affected: None 


Example 1: 

After the execution of 

RES 6,D_ (object code CB, B2H) 

bit 6 in register D will be reset. (Bit @ in register D is the least significant bit.) 


Example 2: 


If HL contains 7000H and address 700Q0H contains FFH, after 
RES @,(HL) 
address 7000H will contain FEH. 















JUMP GROUP 





Jump Group 


JP nn JumP 


Operation: PC nn 


Format: 


Mnemonic: JP Operands: nn 
Object Code: 


1 1 0 0 0 0 1 +%XI4Y °° #2 


Note: The first operand in this assembled object code is the low order byte of a 
2-byte address. 
Description: 


Operand nn is loaded into register pair PC (Program Counter) and points to the 
address of the next program instruction to be executed. 


M cycles: 3 T states: 10(4,3,3) 4 MHz E.T.: 2.50 
Condition Bits Affected: None 


Example: 


JP SOA1 


This instruction will cause the program to jump to the instruction at 50A1H by 
loading the number 50A1H into the PC register. 
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JP Cc,nn JumP 
Operation: IF cc TRUE, PC ann 


Format: 


Mnemonic: JP Operands: cc, nn 
Object Code: 


1 1 ce ce cc O 1 O 


Note: The first n operand in this assembled object code is the low order byte of a 
2-byte memory address. 


Description: 


If condition cc is true, the instruction loads operand nn into register pair PC 
(Program Counter), and the program continues with the instruction beginning at 
address nn. If condition cc is false, the Program Counter is incremented as 
usual, and the program continues with the next sequential instruction. Condition 
cc is programmed as one of eight status bits which correspond to condition bits 
in the Flag Register (register F). These eight status bits are defined in the table 
below, which also specifies the corresponding cc bit fields in the assembled 
object code. 


Relevant 
cc Condition Flag 
000 NZ non-zero Z (=0) 
001 Z zero Z (=l) 
010 NC no-carry C (=0) 
011 Ccarry C (=1) 


100 PO parity odd P/V (=) 
101 PE parity even P/V(=1) 
110 P sign positive S (=0) 
111 Msignnegative S (=1) 


M cycles: 3 T states: 10(4,3,3) 4 MHz E.T.: 2.50 


Condition Bits Affected: None 
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Example: 


If the Carry Flag (C flag in the F register) is set and the contents of address 1520 
are 03H, after the execution of 


JP C,1520H 


the Program Counter will contain 1520H, and on the next machine cycle the 
CPU will fetch from address 1520H the byte 03H. 


JRe | Jump Relative 
Operation: PC 6PC +e 


Format: 


Mnemonic: JR Operands: e 
Object Code: 


0 0 0 1 1 0 0 +0 18 


e-2 e-2 e-2 e-2 e-2 e-2 e-2 e-2 


Description: 


This instruction provides for unconditional branching to other segments of a 
program. The value of the displacement e is added to the Program Counter (PC) 
and the next instruction is fetched from the location designated by the new 
contents of the PC. This jump as measured from the address of the instruction 
opcode has a range of — 126 to + 129 bytes. The assembler automatically 
adjusts for the twice incremented PC. 


M cycles: 3 T states: 12(4,3,5) 4 MHz E.T.: 3.00 
Condition Bits Affected: None 


Example 1: 


To jump forward five locations from address 480, the following assembly 
language statement is used: 
JR $+5 


The resulting object code and final PC value is shown below: 
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Location Instruction 


480 ~=—s«18 
481 03 
482 | —4dQPC before jump 
483 — 
484 — 


485 PC after jump 


Note: when using an assembler, $+5 used above would normally be replaced 
by a label. 


Example 2: 
This program will skip around the NOP instruction. 


START JR, END 
NOP 
END — 


JR Ce Jump Relative 


Operation: If C = 0, continue 
lfC=1,PCé4PC+e 


Format: 


Mnemonic: JR Operands: C, e 
Object Code: 


0 0 1 1 1 0 0 +0 38 


e-2 e-2 e-2 e-2 e-2 e-2 e-2 e-2 





Description: 


This instruction provides for conditional branching to other segments of a 
program depending on the results of a test on the Carry Flag. If the flag is equal 
to a ‘1; the value of the displacement e is added to the Program Counter (PC) 
and the next instruction is fetched from the location designated by the new 
contents of the PC. The jump as measured from the address of the instruction 
opcode has a range of — 126 to +129 bytes. The assembler automatically 
adjusts for the twice incremented PC. 


If the flag is equal to a ‘O; the next instruction to be executed is taken from the 
location following this instruction. 
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If condition is met: 

M cycles: 3 T states: 12(4,3,5) 4 MHz E.T.: 3.00 
If condition is not met: 

M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 


Condition Bits Affected: None 


Example: 

The Carry Flag is set and it is required to jump back four locations from 480. 
The assembly language statement is: 

IR C, $-4 

The resulting object code and final PC value is shown below: 


Location Instruction 


47C = QPC after jump 

47D) — 

47E  —- — 

47F — 

480 = 38 

481 FA (two’s complement — 6) 
482 PC before jump 


JR NC,e Jump Relative 


Operation: If C = 1, continue 
lfC=0,PCGPC+e 


Format: 


Mnemonic: JR Operands: NC, e 
Object Code: 


0 0 1 1 0 0 0 =0 30 





e-2 e-2 e-2 e-2 e-2 e-2 e-2 e-2 


Description: 


This instruction provides for conditional branching to other segments of a 
program depending on the results of a test on the Carry Flag. If the flag is equal 
to ‘Q; the value of the displacement e is added to the Program Counter (PC) and 
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the next instruction is fetched from the location designated by the new contents 
of the PC. The jump as measured from the address of the instruction opcode has 
arange of —126 to +129 bytes. The assembler automatically adjusts for the 
twice incremented PC. 


If the flag is equal to a ‘1, the next instruction to be executed is taken from the 
location following this instruction. 


If the condition is met: 

M cycles: 3 T states: 12(4,3,5) 4 MHz E.T.: 3.00 
If the condition is not met: 

M cycles: 7 T states: 7(4,3) 4 MHz E.T.: 1.75 


Condition Bits Affected: None 


Example: 


The Carry Flag is reset and it is required to repeat the jump instruction. 
The assembly language statement is: 


JR NC,$ 
The resulting object code and PC after the jump are shown below: 


Location Instruction 


480 304PC after jump 
481 FD (two’s complement — 2) 
482 | —4QPC before jump 


Note: this instruction would cause an infinite loop in the program. 


JR Ze Jump Relative 


Operation: Z = @, continue 
IfZ=1,PCGPC+e 


Format: 


Mnemonic: JR Operands: Z, e 
Object Code: 


0 0 1 0 1 0 0 +0 28 


e-2 e-2 e-2 e-2 e-2 e-2 e-2 e-2 
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Description: 


This instruction provides for conditional branching to other segments of a 
program depending on the results of a test on the Zero Flag. If the flag is equal 
to a ‘1; the value of the displacement e is added to the Program Counter (PC) 
and the next instruction is fetched from the location designated by the new 
contents of the PC. The jump as measured from the address of the instruction 
opcode has a range of — 126 to + 129 bytes. The assembler automatically 
adjusts for the twice incremented PC. 


If the Zero Flag is equal to a ‘Q; the next instruction to be executed is taken 
from the location following this instruction. 


If the condition is met: 

M cycles: 3 T states: 12(4,3,5) 4 MHz E.T.: 3.00 
If the condition is not met: 

M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 


Condition Bits Affected: None 


Example: 

The Zero Flag is set and it is required to jump forward five locations from 
address 300. The following assembly language statement is used: 

JR Z, $+5 

The resulting object code and final PC value is shown below: 


Location Instruction 


300 28 

301 03 

302 — (PC before jump 
303 — 

304 — 

305 — (PC after jump 


JR NZ,e Jump Relative 


Operation: If Z=1, continue 
lfZ=0,PCaPC+e 


Format: 


Mnemonic: JR Operands: NZ, e 
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Object Code: 


0 0 10 0 0 0 0 20 


59 60 29 69-69, 62-62-65 





Description: 


This instruction provides for conditional branching to other segments of a 
program depending on the results of a test on the Zero Flag. If the flag is equal 
to a ‘Q; the value of the displacement e is added to the Program Counter (PC) 
and the next instruction is fetched from the location designated by the new 
contents of the PC. The jump as measured from the address of the instruction 
opcode has a range of — 126 to + 129 bytes. The assembler automatically 
adjusts for the twice incremented PC. 


If the Zero Flag is equal to a ‘1; the next instruction to be executed is taken 
from the location following this instruction. 


If the condition is met: 

M cycles: 3 T states: 12(4,3,5) 4 MHz E.T.: 3.00 
If the condition is not met: 

M cycles: 2 T states: 7(4,3) 4 MHz E.T.: 1.75 


Condition Bits Affected: None 


Example: 


The Zero Flag is reset and it is required to jump back four locations from 480. 
The assembly language statement is: 


JR NZ, $-4 


The resulting object code and final PC value is shown below: 


Location Instruction 


47C = PC after jump 

41D — 

47E_ — 

47F — 

480 §=620 

481 FA (two’s complement — 6) 
482 | —4dQPC before jump 
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JP (HL) Jump 
Operation: PC @HL 


Format: 
Mnemonic: JP Operands: (HL) 


Object Code: 


1 1 1 0 1 0 0 1 E9 


Description: 


The Program Counter (register pair PC) is loaded with the contents of the HL 
register pair. The next instruction is fetched from the location designated by the 
new contents of the PC. 


M cycles: 1 T states: 4 4 MHz E.T.: 1.00 
Condition Bits Affected: None 


Example 1: 

If the contents of the Program Counter are 1000H and the contents of the HL 
register pair are 4800H, after the execution of 

JP (HL) 

the contents of the Program Counter will be 4800H. 

The program will jump to the instruction at address 4800H. 


Example 2: 


A typical software routine which uses JP (HL) is a jump table lookup program. 
Assume that n 16-bit addresses are listed in consecutive bytes of memory 
starting at address TBL. Also assume that the Accumulator contains a number 
from Q to n-1 representing the routine to be jumped to. 


LD HL, TBL ; HL points to the first byte in the table. 
ADD A,A - double A 

LD DE, 9 

LD E,A 


ADD HL, DE _ ; if A originally contained 5, then HL now points to the 
5th address in the table 


LD E, (HL) 

INC HL 

LD D, (HL) ; DE now contains the 5th address of the table 
LD HL, DE  ; HL now contains the 5th address of the table 
JP (HL) 
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JP (IX) JumP 


Operation: PC (1X 


Format: 


Mnemonic: JP Operands: (IX) 


Object Code: 
1 1 0 41 1 1 0 = 41 DD 
1 1 1 0 1 0 0 =1 E9 
Description: 


The Program Counter (register pair PC) is loaded with the contents of the 
IX Register Pair (Index Register [X). The next instruction is fetched from the 
location designated by the new contents of the PC. 


M cycles: 2 T states: 8(4,4) 4 MHz ELT.: 2.00 
Condition Bits Affected: None 


Example: 


If the contents of the Program Counter are 100QH, and the contents of the 
IX Register Pair are 4800H, after the execution of 


JP (IX) 
the contents of the Program Counter will be 4800H. 


JP (IY) JumP 
Operation: PC GlY 


Format: 


Mnemonic: JP Operands: (IY) 


Object Code: 
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1 1 1 21 1 #21 ~=0~=1 FD 
1 1 1 0 1 0 0 = =1 E9 
Description: 


The Program Counter (register pair PC) is loaded with the contents of the 
IY Register Pair (Index Register IY). The next instruction is fetched from the 
location designated by the new contents of the PC. 


M cycles: 2 T states: 8(4,4) 4 MHz E.T.: 2.00 
Condition Bits Affected: None 


Example: 


If the contents of the Program Counter are 1000H and the contents of the 
IY Register Pair are 48Q0H, after the execution of 


JP (IY) 
the contents of the Program Counter will be 4800H. 


DJNZ e Decrement Jump Not Zero 


Operation: 


Format: 


Mnemonic: DJNZ Operands: e 
Object Code: 


0 0 0 1 0 0 0 +0 10 


e-2 e-2 e-2 e-2 e-2 e-2 e-2 e-2 





Description: 


The instruction is similar to the conditional jump instructions except that a 

register value is used to determine branching. The B register is decremented 
and if a non zero value remains, the value of the displacement e is added to 
the Program Counter (PC). The next instruction is fetched from the location 
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designated by the new contents of the PC. The jump is measured from 
the address of the instruction opcode has a range of —126 to +129 bytes. 
The assembler automatically adjusts for the twice incremented PC. 


If the result of decrementing leaves B with a zero value, the next instruction 
to be executed is taken from the location following this instruction. 


If B#+0: 

M cycles: 3 T states: 13(5,3,5) 4 MHz E.T.: 3.25 
If B=90: 

M cycles: 2 T. states: 8(5,3) 4 MHz E.T.: 2.00 


Condition Bits Affected: None 


Example: 


A typical software routine is used to demonstrate the use of the DJNZ 
instruction. This routine moves a line from an input buffer (INBUF) to an output 
buffer (OUTBUF). It moves the bytes until it finds a carriage return, or until it 
has moved 80 bytes, whichever occurs first. 


LD B, 80 ; Set up counter 
LD HL, Inbuf ; Set up pointers 
LD DE, Outbuf 
LOOP: LD A, (HL) ; Get next byte from 
; input buffer 
LD (DE), A ; Store in output buffer 
CP QDH — - Is ita CR? 
JR Z, DONE : Yes finished 
INC HL ; Increment pointers 
INC DE 
DJNZ LOOP 3 Loop back if 80 
; bytes have not 
> been moved 


DONE: 
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Call and Return Group 
CALL nn 


Operation: (SP — 1) GPC, (SP — 2) @PC,, PC ann 


Format: 


Mnemonic: CALL Operands: nn 
Object Code: 


1 1 0 0 1 1 =O 1 CD 


Note: The first of the two n operands in the assembled object code above is the 
least significant byte of a two-byte memory address. 


Description: 


After pushing the current contents of the Program Counter (PC) onto the top of 
the external memory stack, the operands nn are loaded into PC to point to the 
address in memory where the first opcode of a subroutine is to be fetched. (At 
the end of the subroutine, a RETurn instruction can be used to return to the 
original program flow by popping the top of the stack back into PC.) The push 
is accomplished by first decrementing the current contents of the Stack Pointer 
(register pair SP), loading the high-order byte of the PC contents into the 
memory address now pointed to by the SP; then decrementing SP again, and 
loading the low-order byte of the PC contents into the top of stack. Note: 
Because this is a three-byte instruction, the Program Counter will have been 
incremented by three before the push is executed. 


M cycles: 5 T states: 17(4,3,4,3,3) 4 MHz E.T.: 4.25 
Condition Bits Affected: None 


Example: 


If the contents of the Program Counter are 1A47H, the contents of the Stack 
Pointer are 3002H, and memory locations have the contents: 
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Location Contents 


1A47H CDH 
1A48H 35H 
1A49H 21H 


then if an instruction fetch sequence begins, the three-byte instruction CD3521H 
will be fetched to the CPU for execution. The mnemonic equivalent of this is 


CALL 2135H 


After the execution of this instruction, the contents of memory address 3001H 
will be 1AH, the contents of address 3000H will be 4AH, the contents of the 

Stack Pointer will be 3000H, and the contents of the Program Counter will be 
2135H, pointing to the address of the first opcode of the subroutine now to be 


executed. 
Before: 
Stack Pointer Address Stack 
3002 3002 50 
3003 1B 
3004 3C 


Program Counter 
1A47 


After CALL 2135H: 


Stack Pointer Address Stack 
3000 3000 4A 
3001 1A 
3002 50 
3003 1B 


Program Counter 
2135 


CALL cc,nn 


Operation: IF cc TRUE: (SP — 1) ¢PC,, 
(SP —2) 4 PC,, PC 4inn 


Format: 


Mnemonic: CALL Operands: cc, nn 
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Object Code: 


1 ce ce ce 1 QO 


josh 
© 


Note: The first of the two n operands in the assembled object code above is the 
least significant byte of the two-byte memory address. 


Description: 


If condition cc is true, this instruction pushes the current contents of the 
Program Counter (PC) onto the top of the external memory stack, then loads 

the operands nn into PC to point to the address in memory where the first 
opcode of a subroutine is to be fetched. (At the end of the subroutine, a RETurn 
instruction can be used to return to the original program flow by popping the top 
of the stack back into PC.) If condition cc is false, the Program Counter is 
incremented as usual, and the program continues with the next sequential 
instruction. The stack push is accomplished by first decrementing the current 
contents of the Stack Pointer (SP), loading the high-order byte of the PC 
contents into the memory address now pointed to by SP, then decrementing 

SP again, and loading the low-order byte of the PC contents into the top of the 
stack. Note: Because this is a three-byte instruction, the Program Counter will 
have been incremented by three before the push is executed. Condition cc is 
programmed as one of eight status bits which corresponds to condition bits in 
the Flag Register (register F). Those eight status bits are defined in the table 
below, which also specifies the corresponding cc bit fields in the assembled 
object code: 


Relevant 

cc Condition Flag 
000 NZ non-zero Z (=90) 
001 Z zero Z (=1) 
010 NC non-carry C (=90) 
011 Ccarry C (=1) 


100 PO parity odd P/V (=90) 
101 PE parity even P/V (= 1) 
110 P sign positive S (=0) 
111 Msignnegative S (=1) 


203 








SERIES | EDITOR/ASSEMBLER 


If cc is true: 

M cycles: 5 T states: 17(4,3,4,3,3) 4 MHz E.T.: 4.25 
If cc 1s false: 

M cycles: 3 T states: 10(4,3,3) 4 MHz E.T.: 2.50 


Condition Bits Affected: None 


Example: 


If the C Flag in the F register is reset, the contents of the Program Counter are 
1A47H, the contents of the Stack Pointer are 3002H, and memory locations 
have the contents: 


Location Contents 


1A47H D4H 
1A48H 35H 
1A49H 21H 


then if an instruction fetch sequence begins, the three-byte instruction D43521H 
will be fetched to the CPU for execution. The mnemonic equivalent of this is 


CALL NC, 2135H 


After the execution of this instruction, the contents of memory address 3001H 
will be 1AH, the contents of address 3000H will be 4AH, the contents of the 
Stack Pointer will be 3000H, and the contents of the Program Counter will be 
2135H, pointing to the address of the first opcode of the subroutine now to be 
executed. 


RET RETurn 


Operation: PC, 4(SP), PC,,4(SP + 1) 


Format: 


Mnemonic: RET Operands: 
Object Code: 


1 1 0 0 1 0 0 = 1 C9 


Description: 


Control is returned to the original program flow by popping the previous 
contents of the Program Counter (PC) off the top of the external memory stack, 
where they were pushed by the CALL instruction. This is accomplished by first 
loading the low-order byte of the PC with the contents of the memory address 
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pointed to by the Stack Pointer (SP), then incrementing the SP and loading the 
high-order byte of the PC with the contents of the memory address now pointed 
to by the SP. (The SP is now incremented a second time.) On the following 
machine cycle the CPU will fetch the next program opcode from the location in 
memory now pointed to by the PC. 


M cycles: 3 T states: 10(4,3,3) 4 MHz ET.: 2.50 
Condition Bits Affected: None 


Example: 


If the contents of the Program Counter are 3535H, the contents of the Stack 
Pointer are 2000H, the contents of memory location 2000H are B5H, and the 
contents of memory location 2001H are 18H, then after the execution of 

RET 

the contents of the Stack Pointer will be 2002H and the contents of the Program 
Counter will be 18B5H, pointing to the address of the next program opcode to 
be fetched. 


Before: 


Program Counter Address Stack 


3535 2000 BS 
2001 18 
2002 2E 
2003 30 
Stack Pointer 
2000 


After RET: 
Program Counter Address Stack 


18B5 2002 2E 
2003 30 
Stack Pointer 
2002 


RET cc RETurn 


Operation: IF cc TRUE: PC, 4(SP), PC, 4(SP +1) 


Format: 


Mnemonic: RET Operands: cc 
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Object Code: 


1 1 ce cc cc O O QO 


Description: 


If condition cc is true, control is returned to the original program flow by 
popping the previous contents of the Program Counter (PC) off the top of the 
external memory stack, where they were pushed by the CALL instruction. This 
is accomplished by first loading the low-order byte of the PC with the contents 
of the memory address pointed to by the Stack Pointer (SP), then incrementing 
the SP, and loading the high-order byte of the PC with the contents of the 
memory address now pointed to by the SP. (The SP is now incremented a 
second time.) On the following machine cycle the CPU will fetch the next 
program opcode from the location in memory now pointed to by the PC. If 
condition cc is false, the PC is simply incremented as usual, and the program 
continues with the next sequential instruction. Condition cc is programmed as 
one of eight status bits which correspond to condition bits in the Flag Register 
F). These eight status bits are defined in the table below, which also specifies 
the corresponding cc bit fields in the assembled object code. 


Relevant 

cc Condition Flag 
000 NZ non-zero Z (=0) 
001 Z zero Z (=1) 
010 NC non-carry C (=0) 
011 Carry C (=1) 


100 PO parity odd P/V (=0) 

101 PE parity even P/V (= 1) 

110 P sign positive S (=0) 

111 M sign negative S (=1) 

If cc is true: 

M cycles: 3 T states: 11(5,3,3) 4 MHz E.T.: 2.75 
If cc is false: 

M cycles: 1 T states: 5 4 MHz E.T.: 1.25 


Condition Bits Affected: None 


Example: 


If the S flag in the F register is set, the contents of the Program Counter are 
3535H, the contents of the Stack Pointer are 2000H, the contents of memory 
location 2000H are B5H, and the contents of memory location 2001H are 18H, 
then after the execution of 


RET M 
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the contents of the Stack Pointer will be 2002H and the contents of the Program 
Counter will be 18B5H, pointing to the address of the next program opcode to 
be fetched. 


RETI 


Operation: Return from interrupt 


Format: 


Mnemonic: RETI Operands: 


Object Code: 
1 1 1 0 1 1 0 =1 ED 
0 10 0 1 1 #0 ~=1 4D 
Description: 


This instruction is used at the end of an interrupt service routine to: 

1. Restore the contents of the Program Counter (PC) (analogous to the RET 
instruction). 

. To signal an I/O device that the interrupt routine has been completed. The 
RETI instruction facilitates the nesting of interrupts, allowing higher priority 


devices to suspend service of lower priority service routines. This instruction 
also resets the IFF1 and IFF2 flip flops. 


M cycles: 4 T states: 14(4,4,3,3) 4 MHz E.T.: 3.50 


NO 


Condition Bits Affected: None 


Example: 


Given: Two interrupting devices, A and B, connected in a daisy chain 
configuration with A having a higher priority than B. 


i A B 
eee nee 
INT 


B generates an interrupt and is acknowledged. (The interrupt enable out, IEO, 
of B goes low, blocking any lower priority devices from interrupting while B is 
being serviced). Then A generates an interrupt, suspending service of B. (The 
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IEO of A goes ‘low’ indicating that a higher priority device is being serviced.) 
The A routine is completed and a RETI is issued resetting the IEO of A, 
allowing the B routine to continue. A second RET] is issued on completion of 
the B routine and the IEO of B is reset (high), allowing lower priority devices 
interrupt access. 


RETN 


Operation: Return from non maskable interrupt 


Format: 


Mnemonic: RETN Operands: 


Object Code: 
1 1 1 0 1 1 #0 =1 ED 
0 10 0 0 1 0 = 41 45 
Description: 


Used at the end of a service routine for a non maskable interrupt, this instruction 
executes an unconditional return which functions identically to the RET 
instruction. That is, the previously stored contents of the Program Counter (PC) 
are popped off the top of the external memory stack; the low-order byte of PC is 
loaded with the contents of the memory location pointed to by the Stack Pointer 
(SP), SP is incremented, the high-order byte of PC is loaded with the contents 
of the memory location now pointed to by SP, and SP is incremented again. 
Control is now returned to the original program flow: on the following machine 
cycle the CPU will fetch the next opcode from the location in memory now 
pointed to by the PC. Also the state of IFF2 is copied back into IFF1 to the state 
it had prior to the acceptance of the NMI. 


M cycles: 4 T states: 14(4,4,3,3) 4 MHz E.T.: 3.50 
Condition Bits Affected: None 


Example: 


If the contents of the Stack Pointer are 1000H and the contents of the Program 
Counter are 1A45H when a non maskable interrupt (NMI) signal is received, the 
CPU will ignore the next instruction and will instead restart to memory address 
0066H. That is, the current Program Counter contents of 1A45H will be pushed 
onto the external stack address of OFFFH and OFFEH, high order byte first, and 
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0066H will be loaded onto the Program Counter. That address begins an 
interrupt service routine which ends with RETN instruction. Upon the execution 
of RETN, the former Program Counter contents are popped off the external 
memory stack, low-order first, resulting in a Stack Pointer contents again of 
1000H. The program flow continues where it left off with an opcode fetch to 
address LA45H. 


RST p ReSTart 
Operation: (SP — 1) PCy, (SP —2) @PC,, PC,4O, PC, @P 


Format: 


Mnemonic: RST Operands: P 
Object Code: 


1 i t t t 21 1 1 


Description: 


The current Program Counter (PC) contents are pushed onto the external 
memory stack, and the page zero memory location given by operand p is loaded 
into the PC. Program execution then begins with the opcode in the address now 
pointed to by PC. The push is performed by first decrementing the contents of 
the Stack Pointer (SP), loading the high-order byte of PC into the memory 
address now pointed to by SP, decrementing SP again, and loading the low- 
order byte of PC into the address now pointed to by SP. The ReSTart instruction 
allows for a Call to a subroutine at one of eight addresses as shown in the table 
below. The operand p is assembled into the object code using the t column of 
the table. Note: Since all addresses are in page zero of memory, the high order 
byte of PC is loaded with QOH. The number selected from the “‘p’’ column of 
the table is loaded into the low-order byte of PC. 


At the end of the subroutine a RETurn instruction can be used to return to the 
original program by popping the top of the stack back into PC. 


P t 
00H 000 
08H 001 
10H 010 
18H 011 
20H 100 
28H 101 
30H 110 
38H 111 


M cycles: 3 T states: 11(5,3,3) 4 MHz E.T.: 2.75 
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Example: 
If the contents of the Program Counter are 15B3H, after the execution of 


RST 18H (Object code 11011111) 


the PC will contain 0018H, as the address of the next opcode to be fetched, and 
the top number on the stack will be 15B3H. 
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Input and Output Group 


IN A,(n) INput 


Operation: A @ (n) 


Format: 


Mnemonic: IN Operands: A, (n) 
Object Code: 


DB 


fo 1.0 k 4 OU: 


Description: 


The number of the input port is n. Data is input to register A. The operand n is 
placed on the bottom half (A@ through A7) of the address bus to select the I/O 
device at one of 256 possible ports. The contents of the Accumulator also 
appear on the top half (A8 through A15) of the address bus at this time. Then 
one byte from the selected port is placed on the data bus and written into the 
Accumulator (register A) in the CPU. 


M cycles: 3 T states: 11(4,3,4) 4 MHz E.T.: 2.75 
Condition Bits Affected: None 


Example: 


If the contents of the Accumulator are 23H and the byte 7BH is available at the 
peripheral device mapped to I/O port address 01H, then after the execution of 
IN A,(@1H) | 


the Accumulator will contain 7BH. 
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IN ,(C) INput 


Operation: r 4 (C) 


Format: 


Mnemonic: IN Operands: r, (C) 


Object Code: 


Description: 


Register C contains the number of the input port. Data is input to register r. 
The contents of register C are placed on the bottom half (A@ through A7) of the 
address bus to select the I/O device at one of 256 possible ports. The contents of 
Register B are placed on the top half (A8 through A15) of the address bus at this 
time. Then one byte from the selected port is placed on the data bus and written 
into register r in the CPU. Register r identifies any of the CPU registers shown 
in the following table, which also shows the corresponding three-bit “‘r’’ field 
for each. The flags will be affected, checking the input data. 


Register r 
B 000 
C 001 
D 010 
E O11 
H 100 
L 101 
A 111 


M cycles: 3 T states: 12(4,4,4) 4 MHz E.T.: 3.00 


Condition Bits Affected: 


S: Set if input data is negative; reset otherwise 
Z: Set if input data is zero; reset otherwise 

H: Reset 

P/V: Set if parity is even; reset otherwise 

N: Reset 

C: Not affected 
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Example: 


If the contents of register C are 07H, the contents of register B are 10H, and the 
byte 7BH is available at the peripheral device mapped to I/O port address 07H, 
then after the execution of 


IN D,(C) 
register D will contain 7BH 


A typical use of the IN r, (C) instruction is for polled I/O. The following 
program continually polls or inputs data from port FF until a non-zero number 
appears. The program then reads in data from port FE. In this application, port 
FF is used as a data ready signal for port FE. 


LD C, OFFH ; C points at port FF 
LOOP IN B, (C) ; Input port FF to register B 

JR Z, LOOP ; continue polling until not zero 

IN A, (@FEH) ; Input port FE to register A 
IN : INput & Increment 
Operation: (HL) 4(C), B@B—1, HLGHL+ 1 


Format: 


Mnemonic: INI Operands: 


Object Code: 


1 Oo 1 0 0 0 1 =O A2 


Description: 


Register C contains the number of the input port. Data input is placed in 
memory at the address pointed at by HL. The contents of register C are placed 
on the bottom half (AQ through A7) of the address bus to select the I/O device at 
one of 256 possible ports. Register B may be used as a byte counter, and its 
contents are placed on the top half (A8 through A15) of the address bus at this 
time. Then one byte from the selected port is placed on the data bus and written 
to the CPU. The contents of the HL register pair are then placed on the address 
bus and the input byte is written into the corresponding location of memory. 
Finally the byte counter is decremented and register pair HL is incremented. 


M cycles: 4 T states: 16(4,5,3,4) 4 MHz E.T.: 4.00 
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Condition Bits Affected: 


S: Unknown 

Z: Set if B—1=90; reset otherwise 
H: Unknown 

P/V: Unknown 

N: Set 

Cc Not affected 

Example: 


If the contents of register C are 07H, the contents of register B are 10H, the 
contents of the HL register pair are 1000H, and the byte 7BH is available at the 
peripheral device mapped to I/O port address 07H, then after the execution of 
INI 


memory location 1000H will contain 7BH, the HL register pair will contain 
1001H, and register B will contain OFH. 


The following program will input data from input ports | through 80 and place 
the data into a buffer in memory. 


LD B, 80 
LD C,0 
LD HL, BUFF 
LOOP INC C 
INI 
JP NZ, LOOP 
IN R INput Increment & Repeat 


Operation: (HL) 4(C), BQB—1, HLGHL+1 


Format: 


Mnemonic: INIR Operands: 


Object Code: 
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Description: 


Register C contains the number of the input port. The data input is placed in 
memory at the address pointed at by the HL register pair. The contents of 
register C are placed on the bottom half (A@ through A7) of the address bus to 
select the I/O device at one of 256 possible ports. Register B is used as a byte 
counter, and its contents are placed on the top half (A8 through A15) of the 
address bus at this time. Then one byte from the selected port is placed on 

the data bus and written to the CPU. The contents of the HL register pair are 
placed on the address bus and the input byte is written into the corresponding 
location of memory. Then register pair HL is incremented, the byte counter is 
decremented. If decrementing causes B to go to zero, the instruction is 
terminated. If B is not zero, the PC is decremented by two and the instruction 
repeated. Note that if B is set to zero prior to instruction execution, 256 bytes 
of data will be input. Also interrupts will be recognized after each data transfer. 


If B#0: 

M cycles: 5 T states: 21(4,5,3,4,5) 4 MHz E.T:: 5.25 
If B=0: 

M cycles: 4 T states: 16(4,5,3,4) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


S: Unknown 
Z: Set 

H: Unknown 
P/V: Unknown 
N: Set 

C: Not affected 
Example: 


If the contents of register C are 07H, the contents of register B are 03H, the 
contents of the HL register pair are 1000H, and the following sequence of 
bytes are available at the peripheral device mapped to I/O port of address 07H: 
51H 

A9H 

03H 

then after the execution of 

INIR 


the HL register pair will contain 1003H, register B will contain zero, and 
memory locations will have contents as follows: 


Location Contents 


1000H 51H 
1001H A9H 
1002H 03H 
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Here is a program to input 80 bytes from I/O port number FF and put them into 
an 80-byte buffer starting at address BUFF. 


LD HL, BUFF ; HL points at first byte of buffer 

LD B, 80 ; load byte counter 

LD C, OFFH ; port FF 

IN IR ; input 80 bytes 

Note: this assumes that the input port can be synchronized with the input 
instructions. 

IN D INput & Decrement 


Operation: (HL) (C), BdB—1, HLGHL—1 


Format: 


Mnemonic: IND Operands: 


Object Code: 
1 1 21 0 1 21 +0 ~=41 ED 
1 oO 1 0 1 0 +1 =«0 AA 
Description: 


The contents of register C are placed on the bottom half (AQ through A7) of the 
address bus to select the I/O device at one of 256 possible ports. Register B may 
be used as a byte counter, and its contents are placed on the top half (A8 
through A15) of the address bus at this time. Then one byte from the selected 
port is placed on the data bus and written to the CPU. The contents of the HL 
register pair are placed on the address bus and the input byte is written into the 
corresponding location of memory. Finally the byte counter and register pair HL 
are decremented. 


M cycles: 4 T states: 16(4,5,3,4) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


S: Unknown 

Z: Set if B—1=@; reset otherwise 
H: Unknown 

P/V: Unknown 

N: Set 

C: Not affected 
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Example: 


If the contents of register C are 07H, the contents of register B are 10H, the 
contents of the HL register pair are 1000H, and the byte 7BH is available at the 
peripheral device mapped to I/O port address 07H, then after the execution of 


IND 


memory location 1000H will contain 7BH, the HL register pair will contain 
OFFFH, and register B will contain OFH. 


IN DR INput Decrement & Repeat 
Operation: (HL) ¢ (C), BdB—1, HL4@HL — 1 


Format: 


Mnemonic: INDR Operands: 


Object Code: 
1 1 1 0 1 21 +0 ~=1 ED 
1 oO 1 1 21 +0 1 ~=0 BA 
Description: 


The contents of register C are placed on the bottom half (A@ through A7) of the 
address bus to select the I/O device at one of 256 possible ports. Register B is 
used as a byte counter, and its contents are placed on the top half (A8 through 
A15) of the address bus at this time. Then one byte from the selected port 

is placed on the data bus and written to the CPU. The contents of the HL 
register pair are placed on the address bus and the input byte is written into 

the corresponding location of memory. Then HL and the byte counter 

are decremented. If decrementing causes B to go to zero, the instruction is 
terminated. If B is not zero, the PC is decremented by two and the instruction 
repeated. Note that if B is set to zero prior to instruction execution, 256 bytes of 
data will be input. Also interrupts will be recognized after each data transfer. 


If B#O: 

M cycles: 5 T states: 21(4,5,3,4,5) 4 MHz E.T.: 5.25 
If B=0: 

M cycles: 4 T states: 16(4,5,3,4) 4 MHz E.T.: 4.00 
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Condition Bits Affected: 


S: Unknown 

Ze Set 

H: Unknown 
P/V: Unknown 
N: Set 

Ce Not affected 
Example: 


If the contents of register C are 07H, the contents of register B are 03H, the 
contents of the HL register pair are 1000H, and the following sequence of bytes 
are available at the peripheral device mapped to I/O port address 07H: 


51H 
A9H 
03H 


then after the execution of 

INDR 

the HL register pair will contain 9FFDH, register B will contain zero, and 
memory locations will have contents as follows: 


Location Contents 


OFFEH 03H 
OFFFH A9H 
1000H 51H 


OUT (n),A OUTput 


Operation: (N) GA 


Format: 


Mnemonic: OUT Operands: (n), A 
Object Code: 


i 1 0 1 0 0 1 +1; ~~ °&2D3 
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Description: 


The operand n is placed on the bottom half (AQ through A7) of the address 
bus to select the I/O device at one of 256 possible ports. The contents of the 
Accumulator (register A) also appear on the top half (A8 through A15) of the 
address bus at this time. Then the byte contained in the Accumulator is placed 
on the data bus and written into the selected peripheral device. 


M cycles: 3 T states: 11(4,3,4) 4 MHz E.T:: 2.75 
Condition Bits Affected: None 


Example: 


If the contents of the Accumulator are 23H, then after the execution of 
OUT 01H,A 


the byte 23H will have been written to the peripheral device mapped to I/O port 
address 01H. 


OUT (C),r OUTput 


Operation: (C) dr 


Format: 


§ 
Mnemonic: OUT Operands: (C), r 
Object Code: 


1 1 1 0 1 21 +0 ~=41 ED 


Description: 


The contents of register C are placed on the bottom half (A@ through A7) of the 
address bus to select the I/O device at one of 256 possible ports. The contents of 
Register B are placed on the top half (A8 through A15) of the address bus at this 
time. Then the byte contained in register r is placed on the data bus and written 
into the selected peripheral device. Register r identifies any of the CPU registers 
shown in the following table, which also shows the corresponding three-bit ‘‘r’’ 
field for each which appears in the assembled object code: 
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Register r 


Se OOo 
= 


M cycles: 3 T states: 12(4,4,4) 4 MHz E.T.: 3.00 
Condition Bits Affected: None 


Example: 


If the contents of register C are 01H and the contents of register D are SAH, 
after the execution of 


OUT (C),D 


the byte SAH will have been written to the peripheral device mapped to I/O port 
address 01H. 


OUT! OUTput & Increment 
Operation: (C) d(HL), BOB—1, HLGHL+1 


Format: 


Mnemonic: OUTI Operands: 


Object Code: 
1 1 1 0 21 21 -=0 =21 ED 
1 Oo 1 0 0 0 1 =«41 A3 
Description: 


The contents of the HL register pair are placed on the address bus to select a 
location in memory. The byte contained in this memory location is temporarily 
stored in the CPU. Then, after the byte counter (B) is decremented, the contents 
of register C are placed on the bottom half (A@ through A7) of the address bus 
to select the I/O device at one of 256 possible ports. Register B may be used as 
a byte counter, and its decremented value is placed on the top half (A8 through 
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A15) of the address bus. The byte to be output is placed on the data bus and 
written into selected peripheral device. Finally the register pair HL is 
incremented. 


M cycles: 4 T states: 16(4,5,3,4) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


S: Unknown 

Zz Set if B— 1 =Q; reset otherwise 
H: Unknown 

P/V: Unknown 

N: Set 

C: Not affected 

Example: 


If the contents of register C are 07H, the contents of register B are 10H, the 
contents of the HL register pair are 1000H, and the contents of memory address 
1QQ0H are 59H, then after the execution of 


OUTI 


register B will contain OFH, the HL register pair will contain 1001H, and the 
byte 59H will have been written to the peripheral device mapped to I/O port 
address 07H. 


OT] R OuTput Increment & Repeat 
Operation: (C) ¢(HL), BGB—1, HLGHL+ 1 


Format: 


Mnemonic: OTIR Operands: 


Object Code: 
1 1 1 0 1 1 +0 =1 ED 
1 oOo 1 1 0 0 1 41 B3 
Description: 


The contents of the HL register pair are placed on the address bus to select a 
location in memory. The byte contained in this memory location is temporarily 
stored in the CPU. Then, after the byte counter (B) is decremented, the contents 
of register C are placed on the bottom half (AQ through A7) of the address bus 
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to select the I/O device at one of 256 possible ports. Register B may be used as 
a byte counter, and its decremented value is placed on the top half (A8 through 
A15) of the address bus at this time. Next the byte to be output is placed on the 
data bus and written into the selected peripheral device. Then register pair HL 
is incremented. If the decremented B register is not zero, the Program Counter 
(PC) is decremented by two and the instruction is repeated. If B has gone to 
zero, the instruction is terminated. Note that if B is set to zero prior to 
instruction execution, the instruction will output 256 bytes of data. Also, 
interrupts will be recognized after each data transfer. 


If B#O: 

M cycles: 5 T states: 21(4,5,3,4,5) 4 MHz E.T.: 5.25 
If B=90: 

M cycles: 4 T states: 16(4,5,3,4) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


S: Unknown 

Z: Set 

H: Unknown 

P/V: Unknown 

N: Set 

C: Not affected 
Example: 


If the contents of register C are 07H, the contents of register B are 03H, the 
contents of the HL register pair are 1Q00H, and memory locations have the 
following contents: 


Location Contents 


1000H 51H 
1001H A9H 
1002H 03H 


then after the execution of 
OTIR 


the HL register pair will contain 1003H, register B will contain zero, and a 
group of bytes will have been written to the peripheral device mapped to I/O 
port address 07H in the following sequence: 


51H 
A9H 
03H 
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OUTD OUTput & Decrement 
Operation: (C) ¢(HL), BQB—1, HLQHL —1 


Format: 
Mnemonic: OUTD Operands: 


Object Code: 
1 1 1 0 1 1 +0 1 ED 
1 oO 1 0 1 0 1 41 AB 
Description: 


The contents of the HL register pair are placed on the address bus to select a 
location in memory. The byte contained in this memory location is temporarily 
stored in the CPU. Then, after the byte counter (B) is decremented, the contents 
of register C are placed on the bottom half (A@ through A7) of the address bus 
to select the I/O device at one of 256 possible ports. Register B may be used as 
a byte counter, and its decremented value is placed on the top half (A8 through 
A15) of the address bus at this time. Next the byte to be output is placed on the 
data bus and written into the selected peripheral device. Finally the register pair 
HL is incremented. 


M cycles: 4 T states: 16(4,5,3,4) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


S: Unknown 

Zi Set if B— 1 =; reset otherwise 
H: Unknown 

P/V: Unknown 

N: Set 

C: Not affected 

Example: 


If the contents of register C are 07H, the contents of register B are 10H, the 
contents of the HL register pair are 1000H, and the contents of memory location 
1000H are 59H, after the execution of 

OUTD 

register B will contain OFH, the HL register pair will contain OFFFH, and the 


byte 59H will have been written to the peripheral device mapped to I/O port 
address 07H. 
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OTD R OUTput Decrement & Repeat 
Operation: (C) q (HL), BdB—1, HLGHL—1 


Format: 


Mnemonic: OTDR Operands: 


Object Code: 
1 | 1 0 1 1 0 = 1 ED 
1 oO 1 1 1 0 1 =41 BB 
Description: 


The contents of the HL register pair are placed on the address bus to select a 
location in memory. The byte contained in this memory location is temporarily 
stored in the CPU. Then, after the byte counter (B) is decremented, the contents 
of register C are placed on the bottom half (AQ through A7) of the address bus 
to select the I/O device at one of 256 possible ports. Register B may be used as 
a byte counter, and its decremented value is placed on the top half (A8 through 
A15) of the address bus at this time. Next the byte to be output is placed on the 
data bus and written into the selected peripheral device. Then register pair HL is 
decremented and if the decremented B register is not zero, the Program Counter 
(PC) is decremented by 2 and the instruction is repeated. If B has gone to zero, 
the instruction is terminated. Note that if B is set to zero prior to instruction 
execution, the instruction will output 256 byte of data. Also, interrupts will be 
recognized after each data transfer. 


If B40: 

M cycles: 5 T states: 21(4,5,3,4,5) 4 MHz E.T.: 5.25 
If B=0: 

M cycles: 4 T states: 16(4,5,3,4) 4 MHz E.T.: 4.00 


Condition Bits Affected: 


S: Unknown 
Z: Set 

H: Unknown 
P/V: Unknown 
N: Set 

C: Not affected 
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Example: 


If the contents of register C are 07H, the contents of register B are 03H, the 
contents of the HL register pair are 1Q00H, and memory locations have the 
following contents: 


Location Contents 


Q®FFEH 51H 

QFFFH A9H 

1000H 03H 

then after the execution of 
OTDR 


the HL register pair will contain OFFDH, register B will contain zero, and a 
group of bytes will have been written to the peripheral device mapped to I/O 
port address 07H in the following sequence: 


03H 
A9H 
51H 
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APPENDIX 


Appendix A/ Using the TPSRC Utility 
(Disk Systems Only) 


This utility allows disk systems to: 


A. Read the source tapes created by the tape version of the Editor/Assembler, 
and copy these to disk. 


B. Copy a disk object file (machine-language program) onto tape in the 
‘“SYSTEM’’ format. 


Under TRSDOS READY, type TPSRC (ENTER). The program will start and ask you to 
select either (1) source tape input or (2) object tape output. 


Source Tape Input 


If you type 1 (ENTER), the program will tell you to get the recorder ready. Get 
your recorder ready to play the source tape (created by the w command of the 
Tape Editor/Assembler). Then press (ENTER). 


TPSRC will read the tape and create a disk file with the same name as the tape 
and with the extension /SRc. The resultant file may be loaded by the Disk Editor/ 
Assembler (L command). 


Object Tape Output 


If you type 2 (ENTER), the program will ask you for the name of the disk file. 
(The file must be in the correct program format, as created by the Disk Editor/ 
Assembler A command.) Type in the file name and press (ENTER). 


Next, TPSRC will prompt you to get the recorder ready. Using a blank tape, 
prepare the recorder to record. Then press (ENTER). TPSRC will then write out the 
object tape. The object tape will be given the name of the disk object file. 


The resultant tape is in the SYSTEM format, and may be loaded according to the 
instructions in Section 5. 
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Appendix B / Model I Subroutines 


These are subroutines which are in the Read Only Memory (ROM) of your Model 
I Level I or Level II BAstc Computer. You can call them using an assembly 
language program. 


The left-hand column lists the subroutines. The next columns demonstrate 
example assembly language programs which call these subroutines. 


If you have a Model I disk system, you can also call subroutines which are a 
part of your TRS-80 Disk Operating System (TRSDOS). These are listed in your 
Model I “‘TRspos Disk BASIC Reference Manual.’ 


The Model III BAsiIc subroutines are listed in the ‘‘TRS-80 Model III Operation 
and BASIC Language Reference Manual.’ (See the Appendix of the Operation 
Section.) The Model III TRspos subroutines are in the ‘‘Technical Information’’ 
of the ‘‘Model III Disk System’s Owners Manual.’ 


Level I BASIC Subroutines 


KEYBOARD SCAN WAIT CALL Q@B4@H + SCAN 
A-register contains input JR 2 WAIT i2= 1 IF KB CLEAR 
byte; input byte is displayed 
at current cursor. 


DISPLAY BYTE PUSH DE sMUST SAVE 
AT CURSOR PUSH Ty 5 DE & IY 
LD A+20H sBYTE TO DISPLAY 
RST 1QH sDISPLAY BYTE 
POP Ty sRESTORE 
POP DE 7 DE & IY 
TURN ON CALL @FESH sTURN ON CASSETTE 
CASSETTE 


On board cassette 1s 
turned on via remote plug 


SAVE MEMORY CALL @FESH sTURN ON CASSETTE 

TO CASSETTE LD HL +70QH START ADDRESS 
Cassette is LD DE»710QH sLAST+1 ADDRESS 
turned off CALL QF 4BH sSAVYE IT 
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LOAD MEMORY FROM CALL QEF 4H 
CASSETTE 
On return 
HL = last + 1 address 
Z = Oif 
checksum error 
Z = 1if 
checksum OK 
Cassette is 
turned off 
RETURN TO Press Reset 
LEVEL I BASIC JP Q 
JP QiCSH 
Level IT BASIC Subroutines 
TURN ON CURSOR PUSH DE 
CHARACTER PUSH IY 
LD A+Q@EH 
CALL 33H 
POP ie 
POP DE 
KEYBOARD SCAN PUSH DE 
A-register contains byte when PUSH ly 
loop falls through. AGN CALL 2BH 
Byte is not displayed on OR A 
Screen! JR 2 »AGN 
POP LY 
POP DE 
DISPLAY BYTE PUSH DE 
AT CURSOR PUSH IY 
LD A»20H 
CALL 33H 
POP LY 
POP DE 
;A-REGISTER SPECIFIES CASSETTE (0 OR 1) 
DEFINE DRIVE LD 4:2 
CALL 0@712H 
WRITE LEADER CALL Q@287H 
AND SYNC BYTE 
TURN OFF CASSETTE CALL Q@1F8H 


iTURN ON & READ 


sPOWER UP 
sRE-ENTRY WITH READY 


sMUST SAVE 

5 DE & IY 

'@EH IS CURSOR BYTE 
‘DISPLAY ROUTINE 
HRESTORE 

+ DE & ITY 


sMUST SAVE 

1 DE & IY 

SOCAN ROUTINE 

1A=@ IF KB CLEAR 
;BRANCH IF NO BYTE 
FRESTORE 

+, DE & IY 


sMUST SAVE 

+ DE & IY 

iBYTE TO DISPLAY 
sDISPLAY 
sRESTORE 

5 DE & IY 


1ON BOARD CASSETTE 
1DEFINE DRIVE 
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SAVE MEMORY 

TO CASSETTE 
User must CALL 264H often 
enough to keep up with 500 
baud. Timing is automatic. 


LOOK FOR LEADER 
AND SYNC BYTE 


LOAD MEMORY FROM 

CASSETTE 
Your program must CALL 
0235H often enough to keep 
up with 500 baud, and must 
do its own checksum if 
desired. A-register contains 
byte read. The user must turn 
off the cassette (CALL 
01F8H) when all bytes have 
been read. 


RETURN TO 
LEVEL If BASIC 


OUTPUT TO LINE PRINTER 
(LEVEL If ONLY) 


PRTOUT 


PRTLPS8 
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LD 
CALL 
CALL 
LD 
CALL 


CALL 
CALL 


LD 

CALL 
CALL 
CALL 


Press RESET 
JP 
JP 


wy 
raw 


LD 


LD 
BIT 
JP 
LD 


wy 
"vis 


RET 


A:@ 

Q212H 
Q287H 
A;:2@0H 
@2G64H 


Q1F8H 
Q@296H 


A+@ 

O212H 
Q29GH 
Q235H 


LAISH 


HL +37E8H 


D+(HL) 
79D 
Z£»PRTLPS 
(HL) +A 


5ON BOARD CASSETTE 
sDEFINE DRIVE 
wWRITE LEADER 
iBYTE TO RECORD 


SQOUTPUT BYTE 


sCASSETTE OFF 


sDEFINE DRIVE 
sFIND SYNC BYTE 
sREAD ONE BYTE 


sLIKE POWER UP 
sRE-ENTRY 


sPUT ASCII BYTE IN 
5A-REGISTER AND CALL 
PRTOUT 

sBUSY CONDITION TESTED 
FOR 


sSAVE REGS. 

sLOAD LP POINTER 

IN HL 

sLOAD LP STATUS BYTE 


:15 THE PRINTER 


BUSY? 


sQUTPUT BYTE TO 
PRINTER 
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Appendix C/Z-80 Status Indicators (Flags) 


The flag register (F and F’) supplies information to the user regarding the status 
of the Z-80 at any given time. The bit positions for each flag are shown below: 


7 65 4 3 #2 421 =«~0 


WHERE: 

C = CARRY FLAG 

N = ADD/SUBTRACT FLAG 
P/V = PARITY/OVERFLOW FLAG 


X = NOT USED 


Each of the two z-80 Flag Registers contains 6 bits of status information which are 
set or reset by CPU operations. (Bits 3 and 5 are not used.) Four of these bits are 
testable (C,P/v,z and s) for use with conditional jump, call or return instructions. 
Two flags are not testable (H,N) and are used for BcD arithmetic. 


Carry Flag (C) 


The carry bit is set or reset depending on the operation begin performed. For ‘ADD’ 
instructions that generate a carry and ‘SUBTRACT’ instructions that generate no bor- 
row, the Carry Flag will be set. The Carry Flag is reset by an App that does not 
generate a carry and a ‘SUBTRACT’ that generates a borrow. This saved carry facil- 
itates software routines for extended precision arithmetic. Also, the ‘DAA’ instruc- 
tion will set the Carry Flag if the conditions for making the decimal adjustment 
are met. 


For instructions RLA, RRA, RLS and RRS, the carry bit is used as a link between the 
LSB and MsB for any register or memory location. During instructions RLCA, RLC’S 
and SLa’s, the carry contains the last value shifted out of bit 7 of any register or 
memory location. During instructions RRCA, RRC’S, SRA’S and SRL’s the carry con- 
tains the last value shifted out of bit 0 of any register or memory location. 


For the logical instructions AND’s, OR’s and xor’s, the carry will be reset. 
The Carry Flag can also be set (SCF) and complemented (CCF). 
Add/Subtract Flag (N) 


This flag is used by the decimal adjust accumulator instruction (DAA) to distingiush 
between ‘ADD’ and ‘SUBTRACT, instructions. For all ‘ADD’ instructions, N will be 
set to a ‘oO. For all ‘SUBTRACT’ instructions, N will be set to a ‘‘1/’ 
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Parity/Overflow Flag (P/V) 
This flag is set to a particular state depending on the operation being performed. 


For arithmetic operations, this flag indicates an overflow condition when the result 
in the Accumulator is greater than the maximum possible number (+ 127) or is 
less than the minimum possible number (— 128). This overflow condition can be 
determined by examining the sign bits of the operands. 


For addition, operands with different signs will never cause overflow. When add- 
ing operands with like signs and the result has a different sign, the overflow flag 
is set. For example: 


+120 = 0111 1000 ADDEND 
+105 = 0110 1001 AUGEND 
+225 11100001 (—95) SUM 


The two numbers added together has resulted in a number that exceeds + 127 and 
the two positive operands has resulted in a negative number ( — 95) which is incor- 
rect. The overflow flag is therefore set. 


For subtraction, overflow can occur for operands of unlike signs. Operands of like 
sign will never cause overflow. For example: 


+127 O111 1111 MINUEND 
(—)- 64 1100 0000 SUBTRAHEND 
+191 1011 1111 DIFFERENCE 


The minuend sign has changed from a positive to a negative, giving an incorrect 
difference. Overflow is therefore set. 


Another method for predicting an overflow is to observe the carry into and out of 
the sign bit. If there is a carry in and no carry out, or if there is no carry in and a 
carry out, then overflow has occurred. 


This flag is also used with logical operations and rotate instructions to indicate the 
parity of the result. The number of ‘1’ bits in a byte are counted. If the total is odd, 
‘ODD’ parity (P= 0) is flagged. If the total is even, ‘EVEN’ parity is flagged (P= 1). 


During search instructions (CPI,CPIR,CPD,CPDR) and block transfer instructions 
(LDI,LDIR,LDD,LDDR) the P/v flag monitors the state of the byte count register (BC). 
When decrementing, the byte counter results in a zero value, the flag is reset to 0, 
otherwise the flag is a Logic 1. 


During LD A,I and LD A,R instructions, the P/v flag will be set with the contents of 
the interrupt enable flip-flop (IFF2) for storage or testing. 


When inputting a byte from an I/O device, IN r,(C), the flag will be adjusted to 
indicate the parity of the data. 


The Half Carry Flag (H) 


The Half Carry Flag (H) will be set or reset depending on the carry and borrow 
status between bits 3 and 4 of an 8-bit arithmetic operation. This flag is used by 
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the decimal adjust accumulator instruction (DAA) to correct the result of a packed 
BCD add or subtract operation. The H flag will be set (1) or rest (0) according to the 


following table: 
SUBTRACT 


There is a carry from There is no borrow from 
Bit 3 to Bit 4 Bit 4 


There is no carry from There is a borrow from 
Bit 3 to Bit 4 Bit 4 





The Zero Flag (Z) 


The Zero Flag (Z) is set or reset if the result generated by the execution of 
certain instructions is a zero. 


For 8-bit arithmetic and logical operations, the z flag will be set to a ‘1’ if the 
resulting byte in the Accumulator is zero. If the byte is not zero, the z flag is 
reset to ‘0. 


For compare (search) instructions, the z flag will be set to a ‘1’ if a comparison 
is found between the value in the Accumulator and the memory location pointed 
to by the contents of the register pair HL. | 


When testing a bit in a register or memory location, the z flag will contain the 
complemented state of the indicated bit (see Bit b,s). 


When inputting or outputting a byte between a memory location and an Vo 
device (INI;IND;OUTI and OUTD), if the result of B-1 1s zero, the Z flag is set, 
otherwise it is reset. Also for byte inputs from Vo devices using IN r,(C), the Z 
Flag is set to indicate a zero byte input. 


The Sign Flag (S) 


The Sign Flag (s) stores the state of the most significant bit of the Accumulator 
(Bit 7). When the zso performs arithmetic operations on signed numbers, binary 
two’s complement notation is used to represent and process numeric 
information. A positive number is identified by a ‘o’ in bit 7. A negative number 
is identified by a ‘1’. The binary equivalent of the magnitude of a positive 
number is stored in bits 0 to 6 for a total range of from 0 to 127. A negative 
number is represented by the two’s complement of the equivalent positive 
number. The total range for negative numbers is from — 1 to — 128. 


When inputting a byte from a Vo device to a register, IN r,(C) the s flag will 
indicate either positive (S =0) or negative (Ss = 1) data. 
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Appendix D 
Numeric List of Instruction Set 


Following is a listing of object codes in numerical order in column two followed by the nmemonic or source 
Statement in column four. 





LOC OBJCODE STMT SOURCE STATEMENT LOC OBJCODE STMT SOURCE STATEMENT 
0000 00 1 NOP 004E 35 54 DEC (HL) 
0001 018405 2 LD BC,NN 004F 3620 55 LD (HL),N 
0004 02 3 LD (BC),A 0051 37 56 SCF 

0005 03 4 INC BC 0052 382E 57 JR C,DIS 
0006 04 5 INC B 0054 39 58 ADD HL,SP 
0007 05 6 DEC B 0055 3A8405 59 LD A,(NN) 
0008 0620 7 LD B,N 0058 3B 60 DEC SP 
000A 07 8 RLCA 0059 3C 61 INC A 
000OB 08 9 EX AF,AF’ 005A 3D 62 DEC A 
000C 09 10 ADD HL,BC 005B 3E20 63 LD A,N 
000D OA 1] LD A,(BC) 005D 3F 64 CCF 

OOOE OB 12 DEC BC OO5E 40 65 LD B,B 
OOOF OC 13 INC C OOSF 41 66 LD B,C 
0010 OD 14 DEC C 0060 42 67 LD B,D 
0011 OE20 15 LD C,N 0061 43 68 LD B,E 
0013 OF 16 RRCA 0062 44 69 LD B,H(NN) 
0014 102E 17 DJNZ DIS 0063 45 70 LD B,L 
0016 118405 18 LD DE,NN 0064 46 71 LD B,(HL) 
0019 12 19 LD (DE),A 0065 47 72 LD B,A 
OO1A 13 20 INC DE 0066 48 73 LD C,B 
0O1B 14 21 INC D 0067 49 74 LD C,C 
OOIC 15 22 DEC D 0068 4A 75 LD C,D 
001D 1620 23 LD D,N 0069 4B 76 LD C,E 
OO1F 17 24 RLA 006A 4C 77 LD C,H 
0020 182E 2 JR DIS 006B 4D 78 LD C,L 
0022 19 26 ADD HL,DE 006C 4E 79 LD C,(HL) 
0023 IA 27 LD A,(DE) 006D 4F 80 LD C,A 
0024 1B 28 DEC DE O06E 50 81 LD D,B 
0025 IC 29 INC E O06F 51 82 LD D,C 
0026 ID 30 DEC E 0070 52 83 LD D,D 
0027 1E20 31 LD E,N 0071 53 84 LD D,E 
0029 IF 32 RRA 0072 54 85 LD D,H 
002A 202E 33 JR NZ,DIS 0073 55 86 LD D,L 
002C 218405 34 LD HL,NN 0074 56 87 LD D,(HL) 
002F 228405 35 LD (NN),HL 0075 57 88 LD D,A 
0032 23 36 INC HL 0076 58 89 LD E,B 
0033 24 37 INC H 0077 59 90 LD E,C 
0034 25 38 DEC H 0078 5A 91 LD E,D 
0035 2620 39 LD H,N 0079 5B 92 LD E,E 
0037 27 40 DAA 007A 5C 93 LD E,H 
0038 282E 4] JR Z,DIS 007B 5D 94 LD E,L 
003A 29 42 ADD HL,HL 007C 5E 95 LD E,(HL) 
003B 2A8405 43 LD HL,(NN) 007D 5F 96 LD E,A 
003E 2B 44 DEC HL OO7E 60 97 LD H,B 
003F 2C 45 INC L OO7F 61 98 LD H,C 
0040 2D 46 DEC L 0080 62 99 LD H,D 
0041 2E20 47 LD L,N 0081 63 100 LD H,E 
0043 2F 48 CPL 0082 64 101 LD H,H 
0044 302E 49 JR NC,DIS 0083 65 102 LD H,L 
0046 318405 50 LD SP,NN 0084 66 103 LD H,(HL) 
0049 328405 51 LD (NN),A 0085 67 104 LDH,A 
004C 33 52 INC SP 0086 68 105 LD L,B 
004D 34 53 INC (HL) 0087 69 106 LD L,C 
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107 
108 
109 
110 
111 

112 
113 
114 
115 
116 
117 
118 
119 
120 
121 

122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 

149 
150 
151 

152 
153 
154 
155 
156 
157 
158 
159 
160 
161 

162 
163 

164 
165 

166 
167 





SOURCE STATEMENT 


LD L,D 
LD L,E 
LD L,H 
LD L,L 
LD L,(HL) 
LD L,A 
LD (HL),B 
LD (HL),C 
LD (HL),D 
LD (HL),E 
LD (HL),H 
LD (HL),L 
HALT 

LD (HL),A 
LD A,B 
LD A,C 
LD A,D 
LD A,E 
LD A,H 
LD A,L 
LD A,(HL) 
LD A,A 
ADD A,B 
ADD A,C 
ADD A,D 
ADD A,E 
ADD A,H 
ADD A,L 
ADD A,(HL) 
ADD A,A 
ADC A,B 
ADC A,C 
ADC A,D 
ADC A,E 
ADC A,H 
ADC A,L 
ADC A,(HL) 
ADC A,A 
SUB B 

SUB C 

SUB D 

SUB E 

SUB H 

SUB L 

SUB (HL) 
SUB A 

SBC A,B 
SBC A,C 
SBC A,D 
SBC A,E 
SBC A,H 
SBC A,L 
SBC A,(HL) 
SBC A,A 
AND B 
AND C 
AND D 
AND E 
AND H 
AND L 
AND (HL) 





LOC 
00C5 
00C6 
00C7 
00C8 
00C9 
00CA 
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168 
169 
170 
17] 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 


187 


188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 





APPENDIX 
SR I EEE 


SOURCE STATEMENT 


AND A 
XOR B 
XOR C 
XOR D 
XOR E 
XOR H 
XOR L 
XOR (HL) 
XOR A 
OR B 

OR C 

OR D 
ORE 

OR H 
ORL 

OR (HL) 
ORA 

CP B 
CPC 

CP D 
CPE 

CP H 
CPL 

CP (HL) 
CPA 
RET NZ 
POP BC 
JP NZ, NN 
JP NN 
CALL NZ,NN 
PUSH BC 
ADD A,N 
RST 0 
RET Z 
RET 

JP Z,NN 
CALL Z,NN 
CALL NN 
ADC A,N 
RST 8 
RET NC 
POP DE 


PUSH DE 
SUB N 

RST 10H 
RET C 

EXX 

JP C,NN 

IN A,N 
CALL C,NN 
SBC A,N 
RST 18H 
RET PO 
POP HL 

JP PO,NN 
EX (SP),HL 
CALL PO,NN 
PUSH HL 
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LOC OBJ CODE STMT SOURCE STATEMENT LOC OBJCODE STMT SOURCE STATEMENT 
0120 E620 229 AND N 0192 CB25 290 SLA L 
0122 £7 230 RST 20H 0194 CB26 291 SLA (HL) 
0123 E8 231 RET PE 0196 CB27 292 SLA A 
0124 E9 232 JP (HL) 0198 CB28 293 SRA B 
0125 EA8405 233 JP PE,NN 019A CB29 294 SRA C 
0128 EB 234 EX DE,HL 019C CB2A 295 SRA D 
0129 EC8405 239 CALL PE,NN 019E CB2B 296 SRA E 
012C EE20 236 XOR N O1A0 CB2C 297 SRA H 
O12E EF 237 RST 28H Q1A2 CB2D 298 SRA L 
O12F FO 238 RET P 01A4 CB2E 299 SRA (HL) 
0130 Fi 239 POP AF 01A6 CB2F 300 SRA A 
0131 F28405 240 JP P,NN 01A8 CB38 301 SRL B 
0134 =F3 241 DI O1AA CB39 302 SRL C 
0135 F48405 242 CALL P,NN O1AC CB3A 303 SRL D 
0138 F5 243 PUSH AF Q1AE CB3B 304 SRLE 
0139 F620 244 OR N 01B0 CB3C 305 SRL H 
013B F7 245 RST 30H 01B2 CB3D 306 SRL L 
013C  F8 246 RET M 01B4 CB3E 307 SRL (HL) 
013D F9 247 LD SP,HL 01B6 CB3F 308 SRL A 
O13E FA8405 248 JP M,NN 01B8 CB40 309 BIT 0,B 
0141 FB 249 EI OIBA CB41 310 BIT 0,C 
0142 FC8405 250 CALL M,NN O1IBC CB42 311 BIT 0,D 
0145 FE20 251 CPN OIBE CB43 312 BIT 0,E 
0147 FF 252 RST 38H 01CO CB44 313 BIT 0,H 
0148 CBOO 253 RLC B 01C2  CB45 314 BIT 0,L 
014A CBOI 254 RLC C 01C4 CB46 315 BIT 0,(HL) 
014C CBO2 255 RLC D 01C6 CB47 316 BIT 0,A 
O14E CBO3 256 RLC E 01C8 CB48 317 BIT 1,B 
0150 CBO04 257 RLC H 01CA CB49 318 BIT 1,C 
0152 CBO5 258 RLC L 01CC CB4A 319 BIT 1,D 
0154 CB06 259 RLC (HL) O1ICE CB4B 320 BIT 1,E 
0156 CBO7 260 RLC A 01D0 CB4C 321 BIT 1,H 
0158 CBO08 261 RRC B 0iD2 CB4D 322 BIT 1,L 
015A CBO9 262 RRC C 01D4 CB4E 323 BIT 1,(HL) 
O1ISC CBOA 263 RRC D 01D6 CB4F 324 BIT 1,A 
O1SE CBOB 264 RRC E 01D8 CBS50 325 BIT 2,B 
0160 CBOC 265 RRC H OIDA CBS51 326 BIT 2,C 
0162 CBOD 266 RRC L 0iDC CB52 327 BIT 2,D 
0164 CBOE 267 RRC (HL) OIDE CBS53 328 BIT 2,E 
0166 CBOF 268 RRC A O1EO0 CB54 329 BIT 2,H 
0168 CBI1O 269 RLB 01E2 CB55 330 BIT 2,L 
016A CBII1 270 RLC O1E4 CB56 331 BIT 2,(HL) 
016C CB12 271 RL D Q01E6 CB57 332 BIT 2,A 
O16E CB13 272 RLE O1E8 CB58 333 BIT 3,B 
0170 CB14 273 RL H QIEA CB59 334 BIT 3,C 
0172 CBI5 274 RLL Q1EC CBSA 335 BIT 3,D 
0174 CBI16 215 RL (HL) QIEE CB5B 336 BIT 3,E 
0176 CBI17 276 RL A 01FO  CBSC 337 BIT 3,H 
0178 CB18 277 RR B 01F2 CB5D 338 BIT 3,L 
O17A CBI19 278 RRC O1F4 CBSE 339 BIT 3,(HL) 
017C CBIA 279 RR D Q1F6 CBSF 340 BIT 3,A 
O17E CBIB 280 RRE O1F8 CB60 341 BIT 4,B 
0180 CBIC 281 RR H QO1FA CB61 342 BIT 4,C 
0182 CBID 282 RRL O1FC CB62 343 BIT 4,D 
0184 CBIE 283 RR (HL) OIFE CB63 344 BIT 4,E 
0186 CBIF 284 RRA 0200 CB64 345 BIT 4,H 
0188 CB20 285 SLA B 0202 CB65 346 BIT 4,L 
018A CB21 286 SLA C 0204 CB66 347 BIT 4,(HL) 
018C CB22 287 SLA D 0206 CB67 348 BIT 4,A 
018E CB23 288 SLA E 0208 CB68 349 BIT 5,B 
0190 CB24 289 SLA H 020A  CB69 350 BIT 5,C 
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LOC OBJCODE STMT SOURCE STATEMENT LOC OBJ CODE STMT SOURCE STATEMENT 
020C CB6A 351 BIT 5,D 0286 CBA7 412 RES 4,A 
020E CB6B 352 BIT 5,E 0288 CBA8 413 RES 5,B 
0210 CB6C 353 BIT 5,H 028A CBA9 414 RES 5,C 
0212 CB6D 354 BIT 5,L 028C CBAA 415 RES 5,D 
0214 CB6E 355 BIT 5,(HL) 028E CBAB 416 RES 5,E 
0216 CB6F 356 BIT 5,A 0290 CBAC 417 RES 5,H 
0218 CB70 357 BIT 6,B 0292 CBAD 418 RES 5,L 
021A CB71 358 BIT 6,C 0294. CBAE 419 RES 5,(HL) 
021C CB72 359 BIT 6,D 0296 CBAF 429 RES 5,A 
021E CB73 360 BIT 6,E 0298 CBBO 421 RES 6,B 
0220 CB74 361 BIT 6,H 029A CBBI 422 RES 6,C 
0222 CB75 362 BIT 6,L 029C CBB2 423 RES 6,D 
0224 CB76 363 BIT 6,(HL) 029E CBB3 424 RES 6,E 
0226 CB77 364 BIT 6,A 02A0 CBB4 425 RES 6,H 
0228 CB78 365 BIT 7,B 02A2 CBBS5 426 RES 6,L 
022A CB79 366 BIT 7,C 02A4 CBB6 427 RES 6,(HL) 
022C CB7A 367 BIT 7,D 02A6 CBB7 428 RES 6,A 
022E CB7B 368 BIT 7,E 02A8 CBB8 429 RES 7,B 
0230 CB7C 369 BIT 7,H 02AA CBB9 430 RES 7,C 
0232 CB7D 370 BIT 7,L 02AC CBBA 431 RES 7,D 
0234 CB7E 371 BIT 7,(HL) 02AE CBBB 432 RES 7,E 
0236 CB7F 372 BIT 7,A 0280 CBBC 433 RES 7,H 
0238 CB80 373 RES 0,B 0282 CBBD 434 RES 7,L 
023A CB81 374 RES 0,C 0284 CBBE 435 RES 7,(HL) 
023C CB82 375 RES 0,D 0286 CBBF 436 RES 7,A 
023E CB83 376 RES 0,E 0288 CBCO 437 SET 0,B 
0240 CB84 377 RES 0,H 02BA CBCI 438 SET 0,C 
0242 CB85 378 RES 0,L 02BC CBC2 439 SET 0,D 
0244 CB86 379 RES 0,(HL) O2BE CBC3 440 SET 0,E 
0246 CB87 380 RES 0,A 02CO CBC4 441 SET 0,H 
0248 CB88 381 RES 1,B 02C2 CBCS5 442 SET 0,L 
024A CB89 382 RES 1,C 02C4 CBC6 443 SET 0,(HL) 
024C CB8A 383 RES 1,D 02C6 CBC7 444 SET 0,A 
024E CB8B 384 RES 1,E 02C8 CBC8 445 SET 1,B 
0250 CB8C 385 RES 1,H 02CA CBC9 446 SET 1,C 
0252 CB8D 386 RES 1,L 02CC CBCA 447 SET 1,D 
0254 CB8E 387 RES 1,(HL) 02CE CBCB 448 SET 1,E 
0256 CB8F 388 RES 1,A 02 CBCC 449 SET 1,H 
0258 CB90 389 RES 2,B 02D2 CBCD 450 SET 1,L 
025A CB91 390 RES 2,C 02D4 CBCE 451 SET 1,(HL) 
025C CB92 391 RES 2,D 02D6 CBCF 452 SET 1,A 
025E CB93 392 RES 2,E 02D8 CBDO 453 SET 2,B 
0260 CB94 393 RES 2,H Q2DA_ CBDI 454 SET 2,C 
0262 CB95 394 RES 2,L 02DC CBD2 455 SET 2,D 
0264 CB96 395 RES 2,(HL) Q2DE CBD3 456 SET 2,E 
0266 CB97 396 RES 2,A 02EO CBD4 457 SET 2,H 
0268 CB98 397 RES 3,B Q2E2 CBD5 458 SET 2,L 
026A CB99 398 RES 3,C 02E4 CBD6 459 SET 2,(HL) 
026C CB9A 399 RES 3,D 02E6 CBD7 460 SET 2,A 
026E CB9B 400 RES 3,E Q2E8 CBD8 461 SET 3,B 
0270 CB9IC 401 RES 3,H Q2EA CBD9 462 SET 3,C 
0272 CB9D 402 RES 3,L 02EC CBDA 463 SET 3,D 
0274 CB9IE 403 RES 3,(HL) Q2EE CBDB 464 SET 3,E 
0276 CB9F 404 RES 3,A 02FO CBDC 465 SET 3,H 
0278 CBAO 405 RES 4,B 02F2 CBDD 466 SET 3,L 
027A CBAI 406 RES 4,C 02F4 CBDE 467 SET 3,(HL) 
027C CBA2 407 RES 4,D Q2F6 CBDF 468 SET 3,A 
027E CBA3 408 RES 4,E 02F8 CBEO 469 SET 4,B 
0280 CBA4 409 RES 4,H Q2FA CBEl 470 SET 4,C 
0282 CBAS5 410 RES 4,L Q2FC CBE2 47] SET 4,D 
0284 CBA6 411 RES 4,(HL) Q2FE CBE3 472 SET 4,E 
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LOC OBJCODE STMT SOURCE STATEMENT LOC OBJCODE STMT SOURCE STATEMENT 

0300 CBE4 473 SET 4,H 0399 DDBEOS 534 CP (IX + IND) 

0302 CBES5 474 SET 4,L 039C DDE 535 POP IX 

0304 CBE6 475 SET 4,(HL) 039E DDE3 536 EX (SP),IX 

0306 CBE7 476 SET 4,A 03A0 DDES 537 PUSH IX 

0308 CBE8 477 SET 5,B 03A2 DDE9 538 JP (IX) 

030A CBE9 478 SET 5,C 03A4 DDF9 539 LD SP,IX 

030C CBEA 479 SET 5,D 0346 DDCB0506 540 RLC (IX + IND) 

030E CBEB 480 SET 5,E 03AA DDCBOSOE 541 RRC (IX + IND) 

0310 CBEC 481 SET 5,H 03AE DDCB0S16 542 RL (IX + IND) 

0312 CBED 482 SET 5,L 03B2 DDCBOSIE 543 RR (IX + IND) 

0314. CBEE 483 SET 5,(HL) 03B6 DDCB0S26 544 SLA (IX + IND) 

0316- CBEF 484 SET 5,A 03BA DDCB0S2E 545 SRA (IX + IND) 

0318 CBFO 485 SET 6,B 03BE DDCB0S3E 546 SRL (IX + IND) 

031A CBFI 486 SET 6,C 03C2 DDCB0S46 547 BIT 0,(1X + IND) 

031C CBF2 487 SET 6,D 03C6 DDCBOS4E 548 BIT 1,(IX + IND) 

031E CBF3 488 SET 6,E 03CA DDCB0S56 549 BIT 2,(IX + IND) 

0320 CBF4 489 SET 6,H 03CE DDCBOSSE 550 BIT 3,(IX + IND) 

0322 CBF5 490 SET 6,L 03D2 DDCB0S66 551 BIT 4,(IX + IND) 

0324 CBF6 491 SET 6,(HL) 03D6 DDCBOS6E 552 BIT 5,(IX+IND) 

0326 CBF7 492 SET 6,A 03DA DDCB0S76 553 BIT 6,(IX + IND) 

0328 CBF8 493 SET 7,B 03DE DDCBOS7TE 554 BIT 7,(IX + IND) 

032A CBF9 494 SET 7,C 03E2 DDCB0S86 555 RES 0,(IX + IND) 

032C CBFA 495 SET 7,D 03E6 DDCBOS8E 556 RES 1,(IX + IND) 

032E CBFB 496 SET 7,E 03EA DDCB0S96 557 RES 2,(IX + IND) 

0330 CBFC 497 SET 7,H 03EE DDCBOS9E 558 RES 3,(IX + IND) 

0332 CBFD 498 SET 7,L 03F2 DDCBOSA6 559 RES 4,(IX + IND) 

0334 CBFE 499 SET 7,(HL) 03F6 DDCBOSAE 560 RES 5,(IX + IND) 

0336 CBFF 500 SET 7,A 03FA DDCBOSB6 561 RES 6,(IX + IND) 

0338 DDO9 501 ADD IX,BC 03FE DDCBOSBE 562 RES 7,(IX + IND) 

033A DD19 502 ADD IX,DE 0402 DDCBOSC6 563 SET 0,(IX + IND) 

033C DD218405 503 LD IX,NN 0406 DDCBOSCE 564 SET 1,(IX + IND) 

0340 DD228405 504 LD (NN), IX 040A DDCBOSD6 565 SET 2,(IX + IND) 

0344 DD23 505 INC IX 040E DDCBOSDE 566 SET 3,(IX + IND) 

0346 DD29 506 ADD IX,IX 0412 DDCBOSE6 567 SET 4,(IX + IND) 

0348 DD2A8405 507 LD IX,(NN) 0416 DDCBOSEE 568 SET 5,(IX + IND) 

034C DD2B 508 DEC IX 041A DDCBOSF6 569 SET 6,(IX + IND) 

034E DD3405 509 INC (IX + IND) 041E DDCBOSFE 570 SET 7,(IX + IND) 

0351  DD3505 510 DEC (IX + IND) 0422  ED40 571 IN B,(C) 

0354 DD360520~—Ss Si LD (IX + IND),N 0424 «=~ED41 572 OUT (C),B 

0358  DD39 512 ADD IX,SP 0426  ED42 573 SBC HL,BC 

035A DD4605 513 LD B,(IX + IND) 0428 ED438405 «574 LD (NN),BC 

035D DD4E05 514 LD C,(IX + IND) 042C ED44 575 NEG 

0360  DD5605 515 LD D,(IX + IND) 042E ED45 576 RETN 

0363 DDSE05 516 LD E,(IX + IND) 0430 ED46 577 IM 0 

0366  DD6605 517 LD H,(IX + IND) 0432 EDA? 578 LD I,A 

0369  DD6E0S 518 LD L,(IX + IND) 0434 ED48 579 IN CC) 

036C DD7005 519 LD (IX + IND),B a of OS 

036F —DD7105 520 LD (IX +IND),C oe ae ol ee 

0372 DD7205 521 LD (IX + IND),D eee BDSBeWs: Re Be) 
043E ED4D 583 RETI 

0375 DD7305 522 LD (IX +IND),E Epdi Rk 

0378  DD7405 523 LD (IX + IND),H ee [DAR 

037B DD7505 524 LD (IX + IND),L 0440 DSO 584 IN D(C) 

037E DD7705 525 LD (IX+IND),A 0442 ~-EDSI 585 OUT (C),D 

0381 DD7E0S5 526 LD A,(IX + IND) 0444 &EDS2 586 SBC HL,DE 

0384 DD8605 527 ADD A,(IX + IND) 0446  ED538405 587 LD (NN),DE 

0387 DD8E0S 528 ADC A,(IX + IND) 044A EDS5S6 588 IM I 

038A DD9605 529 SUB (IX + IND) 044C EDS7 589 LD A,I 

038D DD9E0S 530 SBC A,(IX + IND) 044E  EDS8 590 IN E,(C) 

0390 DDA605 531 AND (IX + IND) 0450 EDS59 591 OUT (C),E 

0393 DDAEO0S 532 XOR (IX + IND) 0452 EDSA 592 ADC HL,DE 

0396  DDB605 533 OR (IX + IND) 0454 EDSB8405 593 LD DE,(NN) 
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ED60 
ED61 
ED62 
ED67 
ED68 
ED69 
ED6A 
ED6F 
ED72 
ED738405 
ED78 
ED79 
ED7A 
ED7B8405 
EDAO 
EDA1 
EDA2 
EDA3 
EDA8 
EDA9 
EDAA 
EDAB 
EDBO 
EDB1 
EDB2 
EDB3 
EDB8 
EDB9 
EDBA 
EDBB 
FD09 
FD19 
FD218405 
FD228405 
FD23 
FD29 
FD2A8405 
FD2B 
FD3405 
FD3505 
FD360520 
FD39 
FD4605 
FD3E05 
FD5605 
FDSE05 
FD6605 
FD6E05 
FD7005 
FD7105 
FD7205 
FD7305 
FD7405 


595 
596 
597 
598 
599 
600 
601 
602 
603 
604 

605 

606 
607 

608 

609 
610 
611 

612 
613 

614 
615 

616 
617 
618 
619 
620 
621 

622 
623 
624 
625 
626 
627 
628 
629 
630 
631 

632 
633 
634 
635 
636 
637 
638 
639 





SOURCE STATEMENT 


IN H,(C) 

OUT (C),H 
SBC HL,HL 
RRD 

IN L,(C) 

OUT (C),L 
ADC HL,HL 
RLD 

SBC HL,SP 

LD (NN),SP 

IN A,(C) 

OUT (C),A 

ADC HL,SP 

LD SP,(NN) 

LDI 

CPI 

INI 

OUTI 

LDD 

CPD 

IND 

OUTD 

LDIR 

CPIR 

INIR 

OTIR 

LDDR 

CPDR 

INDR 

OTDR 

ADD IY,BC 
ADD IY,DE 

LD IY,NN 

LD (NN), IY 

INC IY 

ADD IY,TY 

LD TY,(NN) 
DEC IY 

INC (IY + IND) 
DEC (IY + IND) 
LD (IY + IND),N 
ADD IY,SP 

LD B,(IY + IND) 
LD C,(IY + IND) 
LD D,(IY + IND) 
LD E,(IY + IND) 
LD H,(TY + IND) 
LD L,(TY + IND) 
LD (IY + IND),B 
LD (IY + IND),C 
LD(IY + IND),D 
LD (IY + IND),E 
LD (IY + IND),H 
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FD7505 
FD7705 
FD7E05 
FD8605 


648 
649 
650 
651 
652 
653 
654 
655 
656 
657 
658 
659 
660 
661 
662 
663 
664 
665 
666 
667 
668 
669 
670 
671 
672 
673 
674 
675 
676 
677 
678 
679 
680 
681 
682 
683 
684 
685 
686 
687 
688 
689 
690 
691 
692 
693 
694 
695 NN 
696 IND 
697M 
698 N 
699 DIS 
700 
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SOURCE STATEMENT 


LD (IY + IND),L 
LD (IY + IND),A 
LD A,(IY + IND) 
ADD A,(IY + IND) 
ADC A,(IY + IND) 
SUB-(IY + IND) 
SBC A,(IY + IND) 
AND (IY + IND) 
XOR (IY + IND) 
OR (IY + IND) 
CP (IY + IND) 
POP IY 

EX (SP),IY 

PUSH IY 

JP (IY) 

LD SPY 

RLC (IY + IND) 
RRC (IY + IND) 
RL (IY + IND) 
RR (IY + IND) 
SLA (IY + IND) 
SRA (IY + IND) 
SRL (IY + IND) 
BIT 0,(IY + IND) 
BIT 1,(1Y + IND) 
BIT 2,(1Y + IND) 
BIT 3,(IY + IND) 
BIT 4,(IY + IND) 
BIT 5,(IY + IND) 
BIT 6,(IY + IND) 
BIT 7,(1Y + IND) 
RES 0,(IY + IND) 
RES 1,(1Y + IND) 
RES 2,(IY + IND) 
RES 3,(IY + IND) 
RES 4,(IY + IND) 
RES 5,(1Y + IND) 
RES 6,(IY + IND) 
RES 7,(IY + IND) 
SET 0,(IY + IND) 
SET 1,(IY + IND) 
SET 2,(IY + IND) 
SET 3,(IY + IND) 
SET 4,(IY + IND) 
SET 5,(IY + IND) 
SET 6,(IY + IND) 
SET 7,(IY + IND) 
DEFS 2 

EQU 5 

EQU 10H 

EQU 20H 

EQU 30H 

END 
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Appendix E/Alphabetic List of Instruction Set 


Following is an alphabetical listing of the nmemonic or source statement in column four. The object code is 
shown in column two. 


LOC OBJCODE STMT 





SOURCE STATEMENT LOC OBJCODE STMT SOURCE STATEMENT 

0000 8E 1 ADC A,(HL) 00SC  CB42 56 BIT 0,D 

0001 DD8E0S5 2 ADC A,(IX + IND) 00S5E  CB43 57 BIT 0,E 

0004  FD8E0S5 3 ADC A,(IY + IND) 0060  CBd44 58 BIT 0,H 

0007 8F 4 ADC A.A 0062  CB45 59 BIT 0,L 

0008 88 5 ADC A.B 0064 CB4E 60 BIT 1,(HL) 
0009 89 6 ADC A.C 0066 DDCBOS4E 61 BIT 1,(IX + IND) 
OO0A 8A 7 ADC A.D 006A  FDCBOS4E 62 BIT 1,(IY + IND) 
000B 8B 8 ADC AE 006E  CB4F 63 BIT 1A 

oo0C 8C 9 ADC AH 0070  CB48 64 BIT 1B 

000D 8D 10 ADC AL 0072  CB49 65 BIT 1,C 

QO0E  CE20 1 ADC AN 0074 CB4A 66 BIT 1.D 

0010  ED4A 12 ADC HL,BC 0076  CB4B 67 BIT LE 

0012 EDSA 13 ADC HL,DE 0078  CB4C 68 BIT 1H 

0014 ED6A 14 ADC HL,HL 007A  CB4D 69 BIT LL 

0016 ED7A 15 ADC HL,SP 007C  CBS56 70 BIT 2,(HL) 
0018 86 16 ADD A,(HL) 007E DDCB0556 71 BIT 2,(IX + IND) 
0019  DD8605 17 ADD A,(IX + IND) 0082  FDCB0556 72 BIT 2,(IY + IND) 
001C  FD8605 18 ADD A,(IY + IND) 0086  CBS7 73 BIT 2,A 

OOIF 87 19 ADD A.A 0088 CBSO 74 BIT 2B 

0020 80 20 ADD A.B 008A  CBS5I 75 BIT IC 

0021 81 21 ADD A.C 008C  CBS52 16 BIT 2,D 

0022 82 22 ADD A.D O08E CBS53 77 BIT 2E 

0023 83 23 ADD AE 0090  CBS54 78 BIT 2H 

0024 84 24 ADD AH 0092  CBSS 79 BIT 2,L 

0025 85 25 ADD AL 0094 CBSE 80 BIT 3,(HL) 
0026 620 26 ADD AN 0096 DDCBOSSE 81 BIT 3,(IX + IND) 
0028 09 27 ADD HL,BC 009A FDCBOSSE 82 BIT 3,(TY + IND) 
0029 19 28 ADD HL,DE 009E  CBSF 83 BIT 3,A 

002A 29 29 ADD HL,HL 00A0  CBS58 84 BIT 3,B 

002B 39 30 ADD HL,SP O0A2  CBS59 85 BIT 3.C 

002C  DDO09 31 ADD IX,BC 00A4 CBSA 86 BIT 3,D 

002E DDI9 32 ADD IX,DE 00A6  CBSB 87 BIT 3,.E 

0030  DD29 33 ADD IX,IX O0A8 CBSC 88 BIT 3H 

0032  DD39 34 ADD IX,SP OOAA CBSD 89 BIT 3,L 

0034  FDO09 35 ADD IY,BC OOAC CB66 90 BIT 4 (HL) 
0036  FDI9 36 ADD IY,DE OOAE DDCB0566 91 BIT 4,(IX + IND) 
0038  FD29 37 ADD IY,IY 00B2 FDCB0566 92 BIT 4,(IY + IND) 
003A FD39 38 ADD IY,SP 00B6 CB67 93 BIT 4A 

003C AG 39 AND (HL) 00B8 CB60 94 BIT 4B 

003D DDA605 40 AND (IX + IND) OOBA CB61 95 BIT 4C 

0040  FDA605 41 AND (IY + IND) O0OBC CB62 96 BIT 4,D 

0043. «AT 42 AND A OOBE CB63 97 BIT 45 

0044 AO 43 AND B 00CO CB64 98 BIT 4,H 

0045 Al 44 AND C 00C2  CB65 99 BIT 4,L 

0046 A2 45 AND D 00C4 CBOE 100 BIT 5,(HL) 
0047 A3 46 AND E 00C6 DDCBOS6E 101 BIT 5,(IX + IND) 
0048  A4 47 AND H OOCA FDCBOS6E 102 BIT 5,(1Y + IND) 
0049 AS 48 AND L OOCE CB6F 103 BIT 5,A 

004A 620 49 AND N 00D0  CB68 104 BIT 5B 

004C  CB46 50 BIT 0,(HL) 00D2  CB69 105 BIT 5,C 

004E DDCB0S46 51 BIT 0,(IX + IND) 00D4 CB6A 106 BIT 5,D 

0052 FDBC0546 52 BIT 0,(IY + IND) 00D6 CB6B 107 BIT 5,E 

0056  CB47 53 BIT 0,A 00D8 CB6C 108 BIT 5H 

0058  CB40 54 BIT 0,B OODA CB6D 109 BIT 5. 

005A  CB41 55 BIT 0,C 0ODC CB76 110 BIT 6,(HL) 
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LOC 
00DE 
00E2 
00E6 
00E8 
QOEA 
Q0EC 
QOEE 
00F0 
00F2 
00F4 
00F6 
00FA 
Q0FE 
0100 
0102 
0104 
0106 
0108 
O10A 
010C 
O10F 
0112 
0115 
0118 
O11B 
OE 
0121 
0124 
0127 
0128 
0129 
012C 
O12F 
0130 
0131 
0132 
0133 
0134 
0135 
0136 
0138 
013A 
013C 
013E 
0140 
0141 
0142 
0143 
0146 
0149 
014A 
014B 
014C 
014D 
O14E 
O14F 
0150 
0151 
0152 
0154 
0156 


OBJ CODE 
DDCB0576 
FDCB0576 
CB77 
CB70 
CB71 

CB72 
CB73 
CB74 
CB75 
CB7E 
DDCBO057E 
FDCBO057E 
CB7F 
CB78 
CB79 
CB7A 
CB7B 
CB7C 
CB7D 
DC8405 
FC8405 
D48405 
CD8405 
C48405 
F48405 
EC8405 
E48405 
CC8405 


35 
DD3505 
FD3505 


_ 3D 


05 
OB 
0D 
15 
1B 
1D 
25 
2B 
DD2B 
FD2B 
2D 


STMT 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
14] 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
i) 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 


SOURCE STATEMENT 
BIT 6,(IX + IND) 
BIT 6,([Y + IND) 
BIT 6,A 
BIT 6,B 
BIT 6,C 
BIT 6,D 
BIT 6,E 
BIT 6,H 
BIT 6,L 
BIT 7,(HL) 
BIT 7,(IX + IND) 
BIT 7,(LY + IND) 
BIT 7,A 
BIT 7,B 
BIT EC 
BIT 7,D 
BIT 7,5 
BIT 7,H 
BIT 7,L 
CALL C,NN 
CALL M,NN 
CALL NC,NN 
CALL NN 
CALL NZ,NN 
CALL P,NN 
CALL PE,NN 
CALL PO,NN 
CALL Z,NN 
CCF 
CP (HL) 
CP (IX + IND) 
CP ([Y + IND) 
CP A 
CP B 
CP C 
CP D 
CP E 
CP H 
CP L 
CP N 
CPD 
CPDR 
CPI 
CPIR 
CPL 
DAA 
DEC (HL) 
DEC (IX + IND) 
DEC (TY + IND) 
DEC A 
DEC B 
DEC BC 
DEC C 
DEC D 
DEC DE 
DEC E 
DEC H 
DEC HL 
DEC Ix 
DEC IY 
DEC L 





LOC 
0157 
0158 
0159 
015B 
015C 
015D 
015F 
0161 
0162 
0163 
0164 
0165 
0167 
0169 
016B 
016D 
016F 
0171 
0173 
0175 
0177 
0179 
017B 
017C 
017F 
0182 
0183 
0184 
0185 
0186 
0187 
0188 
0189 
018A 
018B 
018D 
018F 
0190 
0191 
0193 
0195 
0197 
0199 
019A 
019C 
019E 
O1A1 
01A4 
Q1A7 
O1AA 
01AD 
01B0 
01B3 
01B6 
01B9 
01BB 
01BD 
01BF 
01C1 
01C3 
01C4 


OBJ CODE 


FA8405 
D28405 
C38405 
C28405 
F28405 
EA8405 
E28405 
CA8405 
382E 
182E 
302E 
202E 
282E 
02 

12 





STMT 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
19] 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
Z21 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 





APPENDIX 


SOURCE STATEMENT 
DEC SP 
DI 
DINZ DIS 
EI 
EX (SP),HL 
EX (SP),IX 
EX (SP), IY 
EX AF,AF’ 
EX DE,HL 
EXX 
HALT 
IM 0 
IM | 
IM 2 
IN A,(C) 
IN A,N 
IN B,C) 
IN C,(C) 
IN D,(C) 
IN E,(C) 
IN H,(C) 
IN L,(C) 
INC (HL) 
INC (IX + IND) 
INC ([Y + IND) 
INC A 
INC B 
INC BC 
INC C 
INC D 
INC DE 
INC E 
INC H 
INC HL 
INC IX 
INC IY 
INC L 
INC SP 
IND 
INDR 
INI 
INIR 
JP (HL) 
JP (IX) 
JP (IY) 
JP C,NN 
JP M,NN 
JP NC,NN 
JP NN 
JP NZ,NN 
JP P,NN 
JP PE,NN 
JP PO,NN 
JP Z,NN 
JR C,DIS 
JR DIS 
JR NC,DIS 
JR NZ,DIS 
JR Z,DIS 
LD (BC),A 
LD (DE),A 
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LOC OBJCODE STMT SOURCE STATEMENT LOC OBJCODE STMT SOURCE STATEMENT 


O1CS) = 77 233 LD (HL),A 024C FD4E05 294 LD CTY + IND) 
01C6 70 234 LD (HL),B 024F  4F 295 LD C,A 

0107 71 235 LD (HL),C 0250 48 296 LD CB 

01C8 72 236 LD (HL),D 0251 49 297 LD CC 

01C9 = 73 237 LD (HL),E 0252 4A 298 LD C,D 

OICA 74 238 LD (HL),H 0253 4B 299 LD C,E 

OICB 75 239 LD (HL),L 0254 4C 300 LD C,H 

01ICC 3620 240 LD (HL),N 0255 4D 301 LD CL 

QICE DD7705 241 LD (IX+IND),A 0256 0E20 302 LD C,N 

01D1 DD7005 242 LD (IX + IND),B 0258 56 303 LD D,(HL) 

01D4 DD7105 243 LD (IX + IND),C 0259 DD5605 304 LD D,(IX + IND) 
01D7 = DD7205 244 LD (IX + IND), ,D 025C FDS5605 305 LD D,(IY + IND) 
0IDA DD7305 245 LD (IX +IND),E Q25F 57 306 LD D,A 

01IDD DD7405 246 LD (IX + IND),H 0260 50 307 LD D,B 

Q1EO DD7505 247 LD (IX +IND),L 0261 51 308 LD D,C 

01E3 DD360520 248 LD (IX + IND),N 0262 52 309 LD D,D 

Q1E7 ~FD7705 249 LD (IY + IND),A 0263 53 310 LD D,E 

O1EA FD7005 250 LD ([Y + IND),B 0264 54 311 LD D,H 

QIED FD7105 251 LD (IY + IND),C 0265 55 312 LD D,L 

O1FO FD7205 252 LD (TY + IND),D 0266 1620 313 LD D,N 

O1F3  FD7305 253 LD ([Y + IND),E 0268 ED5B8405 314 LD DE,(NN) 
01F6 FD7405 254 LD ([Y + IND),H 026C 118405 315 LD DE,NN 

QO1F9 = FD7505 255 LD (TY + IND),L Q26F SE 316 LD E,(HL) 

QIFC FD360520 256 LD (TY + IND),N 0270 DDSEO0S 317 LD E,(IX + IND) 
0200 328405 257 LD (NN),A 0273 FDSE05 318 LD E,(IY + IND) 
0203 ED438405 258 LD (NN),BC 0276 SF 319 LD E,A 

0207 EDS538405 259 LD (NN),DE 0277 = 58 320 LD E,B 

020B 228405 260 LD (NN),HL 0278 59 321 LD E,C 

Q20E DD228405 261 LD (NN), IX 0279 SA 322 LD E,D 

0202 FD228405 262 LD (NN), TY 027A 5B 323 LD E,E 

0216 ED738405 263 LD (NN),SP 027B 5C 324 LD E,H 

021A OA 264 LD A,(BC) 027C 5D 325 LD EL 

Q2IB_ IA 265 LD A,(DE) 027D 1E20 326 LD E,N 

Q21C 7E 266 LD  A,(HL) O27F 66 327 LD H,(HL) 

021D DD7E0S 267 LD A,(IX + IND) 0280 DD6605 328 LD H,(IX + IND) 
0220 FD7EO0S 268 LD A,(IY + IND) 0283 FD6605 329 LD H,(1Y + IND) 
0223 3A8405 269 LD A,(NN) 0286 =—6/ 330 LD H,A 

0226 7F 270 LD A,A 0287 60 331 LD H,B 

0227 3678 271 LD A,B 0288 61 332 LD H,C 

Q228 79 ai LD A,C 0289 62 333 LD H,D 

0229. 7A Z13 LD A,D 028A 63 334 LD H,E 

Q22A 7B 274 LD A,E 028B 64 335 LD H,H 

022B 7C 219 LD A,H Q28C 65 336 LD H,L 

Q22C EDS57 216 LD A, 028D 2620 337 LD H,N 

Q22E 7D 277 LD A,L O28F  2A8405 338 LD HL,(NN) 
Q22F  3E20 278 LD A,N 0292 218405 339 LD HL,NN 

0231 46 279 LD B,(HL) 0295 ED47 340 LD LA 

0232 DD4605 280 LD B,(IX + IND) 0297 DD2A8405 341] LD IX,(NN) 
0235 FD4605 281 LD B,(IY + IND) 029B DD218405 342 LD IX,NN 

0238 47 282 LD B,A 029F FD2A8405 343 LD TY,(NN) 
0239 40 283 LD B,B 02A3 FD218405 344 LD IY,NN 

Q23A 41 284 LD B,C Q2A7 6E 345 LD L,(HL) 

023B 42 285 LD B,D 02A8 DD6E05 346 LD L,(IX + IND) 
023C 43 286 LD B,E 02AB FD6E05 347 LD L,(IY + IND) 
023D 44 287 LD B,H Q2AE 6F 348 LD L,A 

Q23E 45 288 LD B,L Q2AF 68 349 LD L,B 

Q23F 0620 289 LD B,N 02B0 69 350 LD L,C 

0241 ED4B8405 290 LD BC,(NN) 02B1 6A 351 LD L,D 

0245 018405 291 LD BC,NN 02B2 6B 352 LD L,E 

0248 4E 292 LD C,(HL) 02B3 6C 353 LD L,H 

0249 DD4E05 293 LD C,(IX + IND) 02B4 6D 354 LD L,L 
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LOC OBJ CODE STMT SOURCE STATEMENT LOC OBJCODE STMT SOURCE STATEMENT 
0284 6D 354 LD LL 0324 FDCBOS8E 414 RES 1,(1Y + IND) 
02B5 2E20 355 LD L.N 0328  CB8F 415 RES 1A 
ED4F LD RA 032A CB88 416 RES 1B 
02B7 ED7B8405 356 LD SP,(NN) 032C  CB89 417 RES LC 
02BB  F9 357 LD SP,HL 032E CBSA 418 RES 1D 
02BC DDF9 358 LD SPIX 0330  CB8B 419 RES LE 
02BE FDF9 359 LD SPY 0332 CB8C 420 RES 1H 
02CO 318405 360 LD SP,NN 0334 CB8D 421 RES LL 
02C3. EDA8 361 LDD 0336  CB96 422 RES 2,(HL) 
02C5 EDB8 362 LDDR 0338  DDCB0S96 423 RES 2,(IX + IND) 
02C7 EDAO 363 LDI 033C FDCB05% 424 RES 2,(IY + IND) 
02C9  EDBO 364 LDIR 0340  CB97 425 RES 2,A 
02CB ED44 365 NEG 0342  CB90 426 RES 2.B 
02CD 00 366 NOP 0344 CB91 427 RES 2,C 
02CE B6 367 OR (HL) 0346  CB92 428 RES 2,.D 
02CF DDB605 368 OR (IX + IND) 0348  CB93 429 RES 2E 
02D2 FDB605 369 OR (IY + IND) 034A  CB94 430 RES 2.H 
02D5  B7 370 OR A 034C B95 43] RES 2,L 
02D6 B0 371 OR B 034E  CB9E 432 RES 3,(HL) 
02D7 Bl 372 OR C 0350 DDCBOS9E 433 RES 3,(IX + IND) 
02D8 B2 373 OR D 0354 FDCBOS9E 434 RES 3,(IY + IND) 
02D9 B3 374 OR E 0358  CBOF 435 RES 3,A 
02DA B4 375 OR H 035A  CB98 436 RES 3B 
02DB BS 376 OR L 035C CB99 437 RES 3,C 
02DC F620 377 OR N 035E CB9A 438 RES 3,D 
02DE ED8B 378 OTDR 0360  CB9B 439 RES 3,E 
02E0  EDB3 379 OTIR 0362  CB9C 440 RES 3H 
02E2 ED79 380 OUT (C),A 0364  CBOD 441 RES ne 
02E4 ED4! 381 OUT (C),B 0366  CBA6 442 RES 4,(HL) 
0266 ED49 382 OUT (C),C 0368 DDCBOSA6 443 RES 4,(IX + IND) 
02E8  EDSI 383 OUT (C),D 036C FDCBOSA6 444 RES 4,(IY + IND) 
02EA EDS9 384 OUT (C),E 0370 CBAT7 445 RES 4A 
Q2EC ED61 385 OUT (C),H 0372 CBAO 446 RES 4B 
02EE ED69 386 OUT (C),L 0374 ~«=CBAI 447 RES 4.C 
02FO D320 387 OUT N,A 0376 CBA2 448 RES 4D 
02F2 EDAB 388 OUTD 0378  CBA3 449 RES 45 
02F4 EDA3 389 OUTI 037A CBA4 450 RES 4H 
02F6 FI 390 POP AF 037C  CBAS 451 RES 4,L 
02F7 Cl 391 POP BC 037E CBAE 452 RES 5,(HL) 
02F8 Di 392 POP DE 0380 DDCBOSAE 453 RES 5,(IX + IND) 
02F9 EI 393 POP HL 0384 FDCBOSAE 454 RES 5,(IY + IND) 
02FA DDEI 304 POP IX 0388  CBAF 455 RES 5,A 
Q2FC  FDEI 395 POP IY 038A  CBA8 456 RES 5,B 
Q2FE FS 396 PUSH AF 038C CBA9 457 RES 5,C 
Q2FF CS 397 PUSH BC 038E CBAA 458 RES 5,D 
0300 DS 398 PUSH DE 0390  CBAB 459 RES 5.E 
0301 ES 399 PUSH HL 0392 CBAC 460 RES 5H 
0302  DDES 400 PUSH IX 0394 CBAD 461 RES 5,L 
0304  FDES 401 PUSH IY 0396  CBB6 462 RES 6,(HL) 
0306  CB86 402 RES 0,(HL) 0398 DDCBOSB6 463 RES 6,(IX + IND) 
0308 | DDCB0S86 403 RES 0,(IX + IND) 039C FDCBOSB6 464 RES 6,(IY + IND) 
030C FDCB0S86 404 RES 0,(1Y + IND) 03A0 CBB7 465 RES 6,A 
0310  CB87 405 RES 0,A 03A2 CBBO 466 RES 6,B 
0312 CB80 406 RES 0,B 03A4 CBBI 467 RES 6,C 
0314 CBS8I 407 RES 0,C 0346 CBB2 468 RES 6,D 
0316  CB82 408 RES 0,D 03A8 CBB3 469 RES 6,E 
0318  CB83 409 RES 0,E 03AA CBB4 470 RES 6H 
031A CB84 410 RES 0,H 03AC  CBBS 471 RES 6,L 
031C CB85 411 RES 0,L 03AE CBBE 472 RES 7,(HL) 
031E CBSE 412 RES 1,(HL) 03B0 DDCBOSBE 473 RES 7,(IX + IND) 
0320 DDCBOS8SE 413 RES 1,(IX + IND) 0384 FDCBOSBE 474 RES 7,(IY + IND) 
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LOC OBJCODE STMT SOURCE STATEMENT LOC OBJ CODE STMT SOURCE STATEMENT 
03B8 CBBF 475 RES 7,A 0436 CBOD 536 RRC L 

03BA CBB8 476 RES 7,B 0438 OF 537 RRCA 

03BC CBB9 477 RES 7,C 0439 ED67 538 RRD 

03BE CBBA 478 RES 7,D 043B C7 539 RST 0 

03CO CBBB 479 RES TE 043C D7 540 RST 10H 

03C2 CBBC 480 RES 7,H 043D DF 541 RST 18H 

03C4 CBBD 481 RES 7,L 043E £7 542 RST 20H 

03C6 C9 482 RET 043F EF 543 RST 28H 

03C7 D8 483 RET C 0440 F7 544 RST 30H 

03C8 F8 484 RET M 0441 FF 545 RST 38H 

03C9 DO 485 RET NC 0442 CF 546 RST 08H 

03CA CO 486 RET NZ 0443 9F 547 SBC A,(HL) 
03CB FO 487 RET P 0444 DD9IE0S 548 SBC A,(IX + IND) 
03CC E8 488 RET PE 0447 FD9EOS 549 SBC A,(TY + IND) 
03CD EO 489 RET PO 044A 9F 550 SBC A,A 

0O3CE C8 490 RET Z 0448 98 551 SBC A,B 

03CF ED4D 491 RETI 044C 99 552 SBC A,C 

03D1 ED45 492 RETN 044D 9A 553 SBC A,D 

03D3 CB16 493 RL (HL) 044E 9B 554 SBC A,E 

03D5 DDCBO0516 494 RL (IX + IND) 044F 9C 555 SBC A,H 

03D9 FDCB0516 495 RL (LY + IND) 0450 9D 556 SBC A,L 

03DD CBI7 496 RL A 0451 DE20 557 SBC A,N 

03DF CB10 497 RL B 0453. ED42 558 SBC HL,BC 

Q3E] CBI} 498 RL C 0455 EDS2 559 SBC HL,DE 

03E3. CB12 499 RL D 0457 ED62 560 SBC HL,HL 
Q03E5 C813 500 RL E 0459 ED72 561 SBC HL,SP 

03E7 CBI4 S01 RL H 045B 37 562 SCF 

03E9 CBIS5 502 RL L 045C CBC6 563 SET 0,(HL) 

03EB_ 17 503 RLA 045E DDCBO5C6 564 SET 0,([X + IND) 
03EC CB06 504 RLC (HL) 0462 FDCBO0SC6 565 SET 0,([Y + IND) 
03EE DDCB0506 505 RLC (IX + IND) 0466 CBC7 566 SET 0,A 

03F2 FDCB0506 506 RLC (TY + IND) 0468 CBCO 567 SET 0,B 

03F6 CBO7 507 RLC A 046A CBCl 568 SET 0,C 

03F8 CBO00 508 RLC B 046C CBC2 569 SET 0,D 

03FA CBO! 509 RLC C 046E CBC3 570 SET 0,E 

03FC CBO02 510 RLC D 0470 CBC4 S71 SET 0,H 

Q3FE CBO03 S11 RLC E 0472  CBC5 572 SET 0,L 

0400 CBO04 512 RLC H 0474 CBCE 573 SET 1,(HL) 

0402 CBOS 513 RLC L 0476 DDCBOSCE 574 SET 1,(IX + IND) 
0404 07 514 RLCA 047A FDCBOSCE 575 SET 1,(fY + IND) 
0405  ED6F 515 RLD 047E  CBCF 576 SET 1,A 

0407 CBIE 516 RR (HL) 0480 CBC8 Sh7 SET 1,B 

0409 DDCBOSIE 517 RR (IY + IND) 0482 CBC9 578 SET 1,C 

040D FDCBOSIE 518 RR (IY + IND) 0484 CBCA 579 SET 1,D 

0411 CBIF 519 RR A 0486 CBCB 580 SET 1,E 

0413. CBI8 520 RR B 0488 CBCC 581 SET 1,H 

0415 CB19 521 RR C 048A CBCD 582 SET 1,L 

0417 CBIA 522 RR D 048C CBD6 583 SET 2,(HL) 

0419 CBIB 523 RR E 048E DDCBO5D6 584 SET 2,(IX + IND) 
041B CBIC 524 RR H 0492 FDCBOSD6 585 SET 2,(1Y + IND) 
041D CBID 525 RR L 0496 CBD7 586 SET 2,A 

041F IF 526 RRA 0498 CBDO 587 SET 2,B 

0420 CBOE 527 RRC (HL) 049A CBDI1 588 SET 2,C 

0422 DDCBOSOE 528 RRC (IX + IND) 049C CBD2 589 SET 2,D 

0426 FDCBOS0E 529 RRC (LY + IND) 049E CBD3 590 SET 2E 

042A CBOF 530 RRC A 04A0 CBD4 591 SET 2,H 

042C CBO08 531 RRC B 04A2 CBDS 592 SET 2k 

042E CBO09 532 RRC C 04A4 CBD8 593 SET 3,B 

0430 CBOA 533 RRC D 04A6 CBDE 594 SET 3,(HL) 

0432  CBOB 534 RRC E 04A8 DDCBOSDE 595 SET 3,(IX + IND) 
0434 CBOC 535 RRC H 04AC FDCBOSDE 596 SET 3,(IY + IND) 
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LOC OBJCODE STMT SOURCE STATEMENT LOC OBJCODE STMT SOURCE STATEMENT 


04B4. CBDA 599 SET 3,D QS2E CB23 650 SLA E 

04B6 CBDB 600 SET 3,E 0530 CB24 651 SLA H 

04B8 CBDC 601 SET 3,H 0532 CB25 652 SLA L 

04BA CBDD 602 SET 3,L 0534. CB2E 653 SRA (HL) 

04BC CBE6 603 SET 4,(HL) 0536 DDCBOS2E 654 SRA (IX + IND) 
04BE DDCBOSE6 604 SET 4,(IX + IND) 053A FDCB052E 655 SRA (IY + IND) 
04C2 FDCBOSE6 605 SET 4,(Y + IND) Q053E  CB2F 656 SRA A 

04C6 CBE? 606 SET 4,A 0540 CB28 657 SRA B 

04C8 CBEO 607 SET 4,B 0542 CB29 658 SRA C 

04CA CBE 608 SET 4,C 0544 CB2A 659 SRA D 

04CC CBE2 609 SET 4,D 0546 CB2B 660 SRA E 

04CE CBE3 610 SET 4,E 0548  CB2C 661 SRA H 

04D0 CBE4 611 SET 4,H 054A CB2D 662 SRA L 

04D2 CBES5 612 SET 4,L 054C CB3E 663 SRL (HL) 

04D4 CBEE 613 SET 5,(HL) 0S4E DDCBOS3E 664 SRL (IX + IND) 
04D6 DDCBOSEE 614 SET 5,([X + IND) 0552 FDCBO53E 665 SRL (TY + IND) 
04DA FDCBOSEE 615 SET 5,(TY + IND) 0556 CB3F 666 SRL A 

04DE CBEF 616 SET 5,A 0558 CB38 667 SRL B 

04EO0 CBE8 617 SET 5,B 055A CB39 668 SRL C 

04E2 CBE9 618 SET 5; 055C CB3A 669 SRL D 

04E4 CBEA 619 SET 5,D QSSE CB3B 6/0 SRL E 

04E6 CBEB 620 SET 5,E 0560 CB3C 671 SRL H 

04E8 CBEC 621 SET 5,H 0562 CB3D 672 SRL L 

04EA CBED 622 SET 5,L 0564 6 673 SUB (HL) 

04EC CBF6 623 SET 6,(HL) 0565 DD9605 674 SUB (IX + IND) 
04EE DDCBOSF6 624 SET 6,([X + IND) 0568 FD9605 675 SUB (TY + IND) 
04F2 FDCBOSF6 625 SET 6,(IY + IND) 056B 97 676 SUB A 

04F6 = CBF? 626 SET 6,A 056C 90 677 SUB B 

04F8 CBFO 627 SET 6,B 056D 91 678 SUB C 

O4FA CBF1 628 SET 6,C QS6E 92 679 SUB D 

O04FC CBF2 629 SET 6,D Q5S6F 93 680 SUB E 

O4FE CBF3 630 SET 6,E 0570 94 681 SUB H 

0500 CBF4 631 SET 6,H 0571 = 95 682 SUB L 

0502 CBF5 632 SET 6,L 0572 D620 683 SUB N 

0504 CBFE 633 SET 7,(HL) 0574 AE 684 XOR (HL) 

0506 DDCBOSFE 634 SET 7,(IX + IND) 0575 DDAEOS 685 XOR (IX + IND) 
050A FDCBOSFE 635 SET 7,(TY + IND) 0578 | FDAE05 686 XOR (IY + IND) 
QSOE CBFF 636 SET 7,A 057B AF 687 XOR A 

0510 CBF8 637 SET 7,B 057C — A8 688 XOR B 

0512 CF9 638 SET 7,C 057D A9 689 XOR C 

0514 CBFA 639 SET 7,D OS7E AA 690 XOR D 

0516 CBFB 640 SET 7,E QOS7F AB 691 XOR E 

0518 CBFC 641 SET 7,H 0580 AC 692 XOR H 

051A CBFD 642 SET 7,L 0581 AD 693 XOR L 

0S1IC CB26 643 SLA (HL) 0582 EE20 694 XOR N 

0S1E DDCB0526 644 SLA (IX + IND) 0584 695 NN DEFS 2 

0522 FDCB0526 645 SLA (IY + IND) 696 IND EQU 5 

0526 CB27 646 SLA A 697 M EQU 10H 

0528 CB20 647 SLA B 698 N EQU 20H 

Q52A CB21 648 SLA C 699 DIS EQU 30H 

052C CB22 649 SLA D 700 END 
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AppendixF /Z-80 CPU Register and 
Architecture 


This section gives information about the actual Z80 chip including the Central 
Processing Unit (CPU) Register configuration. 


Z-80 CPU Architecture 


A block diagram of the internal architecture of the z-30 CPU is shown in Figure 
2. The diagram shows all of the major elements in the cpu and it should be 
referred to throughout the following description. 


CPU Registers 


The Z-80 CPU contains 208 bits of R‘W memory that are accessible to the 
programmer. Figure 3 illustrates how this memory is configured into eighteen 
8-bit registers and four 16-bit registers. All Z-80 registers are implemented using 
static RAM. The registers include two sets of six general purpose registers that 
may be used individually as 8-bit registers or in pairs of 16-bit registers. There 
are also two sets of accumulator and flag registers. 


Special Purpose Registers 


8-BIT 

DATA BUS 
DATA BUS 
CONTROL 





INTERNAL DATA BUS 


CPU 
REGISTERS 
Ce CPU 
CONTROL 


a ADDRESS 
| CONTROL 


+5V GND ead 
ADORESS BUS 





SIGNALS 





Figure 2, Z-80 CPU Block Diagram. 
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MAIN REG SET ALTERNATE REG SET 


GENERAL 
PURPOSE 
REGISTERS 





INTERRUPT MEMORY 
VECTOR REFRESH 
t R 


INDEX REGISTER IX 










SPECIAL 
PURPOSE 


INDEX REGISTER IY REGISTERS 


STACK POINTER SP 


PROGRAM COUNTER PC 


Figure 3, Z-80 CPU Register Configuration. 


1. 


as 


> 


Program Counter (PC). The program counter holds the 16-bit address of the 
current instruction being fetched from memory. The Pc is automatically 
incremented after its contents have been transferred to the address lines. 
When a program jump occurs the new value is automatically placed in the Pc, 
overriding the incrementer. 


Stack Pointer (SP). The stack pointer holds the 16-bit address of the current 
top of a stack located anywhere in external system RAM memory. The 
external stack memory is organized as a last-in first-out (LIFO) file. 


Data can be pushed onto the stack from specific CPU registers or popped off 
of the stack into specific CPU registers through the execution of PUSH and POP 
instructions. The data popped from the stack is always the last data pushed 
onto it. The stack allows simple implementation of multiple level interrupts, 
unlimited subroutine nesting and simplification of many types of data 
manipulation. 


Two Index Register (Ix & IY). The two independent index registers hold a 
16-bit base address that is used in indexed addressing modes. In this mode, 
an index register is used as a base to point to a region in memory from which 
data is to be stored or retrieved. An additional byte is included in indexed 
instructions to specify a displacement from this base. This displacement is 


specified as a two’s complement signed integer. This mode of addressing 


greatly simplifies many types of programs, especially where tables of data 
are used. 
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4. Interrupt Page Address Register (1). The z-80 cpu can be operated in a 
mode where an indirect call to any memory location can be achieved in 
response to an interrupt. The 1 Register is used for this purpose to store the 
high order 8-bits of the indirect address while the interrupting device provides 
the lower 8-bits of the address. This feature allows interrupt routines to be 
dynamically located anywhere in memory with absolute minimal access time 
to the routine. 


5. Memory Refresh Register (R). The zZ-80 cPU contains a memory refresh 
counter to enable dynamic memories to be used with the same ease as Static 
memories. Seven bits of this 8 bit register are automatically incremented after 
each instruction fetch. The eighth bit will remain as programmed as the result 
of an LDR, A instruction. The data in the refresh counter is sent out on the 
lower portion of the address bus along with a refresh control signal while the 
CPU is decoding and executing the fetched instruction. This mode of refresh is 
totally transparent to the programmer and does not slow down the cpu 
operation. The programmer can load the R register for testing purposes, but 
this register is normally not used by the programmer. During refresh, the 
contents of the I register are placed on the upper 8 bits of the address bus. 


Accumulator and Flag Registers 


The cpu includes two independent 8-bit accumulators and associated 8-bit flag 
registers. The accumulator holds the results of 8-bit arithmetic or logical 
operations while the flag register indicates specific conditions for 8 or 16-bit 
operations, such as indicating whether or not the result of an operation is equal 
to zero. The programmer selects the accumulator and flag pair that he wishes to 
work with a single exchange instruction so that he may easily work with either 
pair. 


General Purpose Registers 


There are two matched sets of general purpose registers, each set containing six 
8-bit registers that may be used individually as 8-bit registers or as 16-bit 
register pairs by the programmer. One set is called BC, DE and HL while the 
complementary set is called BC, DE and HL,’ At any one time the programmer 
can select either set of registers to work with through a single exchange 
command for the entire set. In systems where fast interrupt response is required, 
one set of general purpose registers and an accumulator/flag register may be 
reserved for handling this very fast routine. Only a simple exchange command 
need be executed to go between the routines. This greatly reduces interrupt 
service time by eliminating the requirement for saving and retrieving register 
contents in the external stack during interrupt or subroutine processing. These 
general purpose registers are used for a wide range of applications by the 
programmer. They also simplify programming, especially in ROM based systems 
where little external read/write memory is available. 
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Arithmetic & Logic Unit (ALU) 


The 8-bit arithmetic and logical instructions of the CPU are executed in the ALU. 
Internally the ALU communicates with the registers and the external data bus on 
the internal data bus. The type of functions performed by the ALU include: 


Add Left or right shifts or rotates (arithmetic and logical) 
Subtract Increment 

Logical AND Decrement 

Logical OR Set bit 


Logical Exclusive oR Reset bit 
Compare Test Bit 


Instruction Register and CPU Control 


As each instruction is fetched from memory, it is placed in the instruction 
register and decoded. The control sections performs this function and then 
generates and supplies all of the control signals necessary to read or write data 
from or to the registers, control the ALU and provide all required external control 
signals. 


Z-80 CPU Pin Description 


The Z-80 CPU is packaged in an industry standard 40 pin Dual In-Line Package. 
The Vo pins are shown in Figure 4 and the function of each is described below. 


Ag-Ajs Tri-state output, active high. Ag-A,; constitute a 16-bit 

(Address Bus) address bus. The address bus provides the address for 
memory (up to 64K bytes) data exchanges and for I/O 
device data exchanges. I/O addressing uses the 8 lower 
address bits to allow the user to directly select up to 256 
input or 256 output ports. Ag is the least significant address 
bit. During refresh time, the lower 7 bits contain a valid 
refresh address. 


D,-D; Tri-state input/output, active high. Da-D, constitute an 

(Data Bus) 8-bit bidirectional data bus. The data bus is used for data 
exchanges with memory and I/O devices. 

M, Output, active low. M, indicates that the current machine 

(Machine Cycle cycle is the OP code fetch cycle of an instruction execution. 

one) Note that during execution of 2-byte op-codes, M, is 


generated as each op-code byte is fetched. These two byte _ 
op-codes always begin with CBH, DDH, EDH or FDH. M, 
also occurs with IORQ to indicate an interrupt acknowledge 
cycle. 
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Figure 4, Z-80 Pin Configuration. 


MREQ 
(Memory 
Request) 


IORQ 
(Input/Output 
Request) 


RD 


(Memory Read) 


WR 
(Memory Write) 


Tri-state output, active low. The memory request signal © 
indicates that the address bus holds a valid address for a 
memory read or memory write operation. 


Tri-state output, active low. The IORQ signal indicates that 
the lower half of the address bus holds a valid I/O address 
for a I/O read or write operation. An IORQ signal is also 
generated with an M, signal when an interrupt is being 
acknowledged to indicate that an interrupt response vector 
can be placed on the data bus. Interrupt Acknowledge 
operations occur during M, time while I/O operations never 
occur during M, time. 





Tri-state output, active low. RD indicates that the CPU 
wants to read data from memory or an I/O device. The 
addressed I/O device or memory should use this signal to 
gate data onto the CPU data bus. 


Tri-state output, active low. WR indicates that the CPU data 
bus holds valid data to be stored in the addressed memory 
or I/O device. 
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RFSH 
(Refresh) 


HALT 
(Halt state) 


WAIT 
(Wait) 


INT 
(Interrupt 
Request) 


NMI 
(Non Maskable 
Interrupt) 


RESET 


Output, active low. RFSH indicates that the lower 7 bits of 
the address bus contain a refresh address for dynamic 
memories and the current MREQ signal should be used to 
do a refresh read to all dynamic memories. 





Output, active low. HALT indicates that the CPU has 
executed a HALT software instruction and is awaiting either 
a non maskable or a maskable interrupt (with the mask 
enabled) before operation can resume. While halted, the 
CPU executes NOP’s to maintain memory refresh activity. 


Input, active low. WAIT indicates to the Z-80 CPU that the 
addressed memory or I/O devices are not ready for a data 
transfer. The CPU continues to enter wait states for as long 
as this signal is active. This signal allows memory or I/O 
devices of any speed to be synchronized to the CPU. 


Input, active low. The Interrupt Request signal is generated 
by I/O devices. A request will be honored at the end of 

the current instruction if the internal software controlled 
interrupt enable flip-flop (IFF) is enabled and if the BUSRQ 
signal is not active. When the CPU accepts the interrupt, an 
acknowledge signal TORQ during M, time) is sent out at 
the beginning of the next instruction cycle. 








Input, negative edge triggered. The non maskable interrupt 
request line has a higher priority than INT and is always 
recognized at the end of the current instruction, independent 
of the status of the interrupt enable flip-flop. NMI 
automatically forces the Z-80 CPU to restart to location 
0066,;. The program counter is automatically saved in the 
external stack so that the user can return to the program that 
was interrupted. Note that continuous WAIT cycles can 
prevent the current instruction from ending, and that a 
BUSRQ will override a NMI. 





Input, active low. RESET forces the program counter to 
zero and initializes the CPU. The CPU initialization 
includes: 


1) Disable the interrupt enable flip-flop 
2) Set Register I = 00, 

3) Set Register R = 00, 

4) Set Interrupt Mode 0 


During reset time, the address bus and data bus go to a high 
impedance state and all control output signals go to the 
inactive state. 
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BUSRQ Input, active low. The bus request signal is used to request 

(Bus Request) the CPU address bus, data bus and tri-state output control 
signals to go to a high impedance state so that other devices 
can control these buses. When BUSRQ is activated, the 
CPU will set these buses to a high impedance state as soon 
as the current CPU machine cycle is terminated. 





BUSAK Output, active low. Bus acknowledge is used to indicate to 

(Bus the requesting device that the CPU address bus, data bus 

Acknowledge) and tri-state control bus signals have been set to their high 
impedance state and the external device can now control 
these signals. 


® Single phase TTL level clock which requires only a 330 
ohm pull-up resistor to +5 volts to meet all clock 
requirements. 


Z-80 CPU Instruction Set 


The Z-80 CPU can execute 158 different instruction types including all 78 of the 
8080A cpu. The instructions can be broken down into the following major 
groups: 

¢ Load and Exchange 

¢ Block Transfer and Search 

¢ Arithmetic and Logical 

¢ Rotate and Shift 

¢ Bit Manipulation (set, reset, test) 

¢ Jump, Call and Return 

¢ Input/Output 

¢ Basic cpu Control 
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IMPORTANT NOTICE 


ALL RADIO SHACK COMPUTER PROGRAMS ARE LICENSED ON AN 
“AS IS” BASIS WITHOUT WARRANTY. 


Radio Shack shall have no liability or responsibility to customer or any 
other person or entity with respect to any liability, loss or damage caused or 
alleged to be caused directly or indirectly by computer equipment or pro- 
grams sold by Radio Shack, including but not limited to any interruption of 
service, loss of business or anticipatory profits or consequential damages 
resulting from the use or operation of such computer or computer programs. 
NOTE: Good data processing procedure dictates that the user test the 
program, run and test sample sets of data, and run the system in 
parallel with the system previously in use for a period of time 
adequate to insure that results of operation of the computer or 
program are satisfactory. 


RADIO SHACK SOFTWARE LICENSE 


A. Radio Shack grants to CUSTOMER a non-exclusive, paid up license 
to use on CUSTOMER’S computer the Radio Shack computer software 
received. Title to the media on which the software is recorded (cassette 
and/or disk) or stored (ROM) is transferred to the CUSTOMER, but not title 
to the software. 


B. In consideration for this license, CUSTOMER shall not reproduce 
copies of Radio Shack software except to reproduce the number of copies 
required for use on CUSTOMER’S computer (if the software allows a back- 
up copy to be made), and shall include Radio Shack’s copyright notice on 
all copies of software reproduced in whole or in part. 


_ 


C. CUSTOMER may resell Radio Shack’s system and applications soft- 
ware (modified or not, in whole or in part), provided CUSTOMER has 
purchased one copy of the software for each one resold. The provisions of 
this software License (paragraphs A, B, and C) shall also be applicable to 
third parties purchasing such software from CUSTOMER. 
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